IM RESTful API 提供给开发者 IM 业务的接口,客户端和服务端 API 能力对称,开发者可通过 API 接口实现用户管理
、群组管理
等,详细请参考接口清单 RESTful API
为了通信安全,API 通过自定义公共 header 进行鉴权
格式说明
https://$api/$version/$command
参数 | 名称 | 描述 | |
---|---|---|---|
$api | 请求域名 | 私有云部署服务后可获得请求地址 | |
$version | 版本 | API 的版本号 | |
$command | 请求指令 | 具体的接口地址 |
请求头
请求头 | 必填 | 描述 | 备注 |
---|---|---|---|
appkey | 是 | 应用的唯一标识 | |
nonce | 是 | 随机数字,长度 8 位 | |
timestamp | 是 | 时间戳,精确到毫秒 | |
signature | 是 | sha1 计算的签名,向严格按照 签名 计算规则 |
签名计算
签名计算,需要与 appkey 对应的 appsecret 创建应用获取
// 顺序必须必须严格按:appsecret -> nonce -> timestamp
signature = SHA1({appsecret}{nonce}{timestamp})