跳转至

消息优先级

通过聊天室消息优先级接口,设置的消息类型为 Low Level 的消息,默认情况下全部为 High Level 的消息,当服务器负载高时 Low Level 的消息优先被丢弃,这样可以让出资源给 High Level 的消息,确保重要的消息不被丢弃,设置 30 分钟后生效。

提示

此服务在开通 IM 商用版的情况下,可申请开通,详细请联系商务,电话:13161856839。

添加

方法名:/chatroom/message/priority/add

签名方法:请参考 通用 API 接口签名规则

URL:http(s)://api-cn.ronghub.com/chatroom/message/priority/add.[format]

[format] 表示返回格式,可以为 jsonxml,注意不要带 [ ]。

HTTP 方法:POST

表单参数

名称 类型 说明
objectName String 低优先级的消息类型,每次最多提交 5 个,设置的消息类型最多不超过 20 个。(必传)

返回值

名称 类型 说明
code Int 返回码,200 为正常。

JSON 格式:

{"code":200}

XML 格式:

<code>200</code>

返回值请参考 API 方法返回值说明

示例

HTTP 请求:

POST /chatroom/message/priority/add.json HTTP/1.1
Host: api-cn.ronghub.com
App-Key: uwd1c0sxdlx2
Timestamp: 1408710653491
Nonce:14314
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: Application/x-www-form-urlencoded

objectName=RC:VcMsg&objectName=RC:ImgTextMsg&objectName=RC:ImgMsg

HTTP 响应:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"code":200}

移除

方法名:/chatroom/message/priority/remove

签名方法:请参考 通用 API 接口签名规则

URL:http(s)://api-cn.ronghub.com/chatroom/message/priority/remove.[format]

[format] 表示返回格式,可以为 jsonxml,注意不要带 [ ]。

HTTP 方法:POST

表单参数

名称 类型 说明
objectName String 低优先级的消息类型,每次最多提交 5 个

返回值

名称 类型 说明
code Int 返回码,200 为正常。

JSON 格式:

{"code":200}

XML 格式:

<code>200</code>

返回值请参考 API 方法返回值说明

示例

HTTP 请求:

POST /chatroom/message/priority/remove.json HTTP/1.1
Host: api-cn.ronghub.com
App-Key: uwd1c0sxdlx2
Timestamp: 1408710653491
Nonce:14314
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: Application/x-www-form-urlencoded

objectName=RC:VcMsg&objectName=RC:ImgMsg

HTTP 响应:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"code":200}

查询

方法名:/chatroom/message/priority/query

签名方法:请参考 通用 API 接口签名规则

URL:http(s)://api-cn.ronghub.com/chatroom/message/priority/query.[format]

[format] 表示返回格式,可以为 jsonxml,注意不要带 [ ]。

HTTP 方法:POST

表单参数

返回值

名称 类型 说明
code Int 返回码,200 为正常。
objectNames String[] 消息类型数组。

JSON 格式:

{
  "code":200,
  "objectNames":["RC:ImgMsg","RC:ImgTextMsg","RC:VcMsg"]
}

XML 格式:

<xml>
  <code>200</code>
  <objectNames>
    <string>RC:ImgMsg</string>
    <string>RC:ImgTextMsg</string>
    <string>RC:VcMsg</string>
  </objectNames>
</xml>

返回值请参考 API 方法返回值说明

示例

HTTP 请求:

POST /chatroom/message/priority/query.json HTTP/1.1
Host: api-cn.ronghub.com
App-Key: uwd1c0sxdlx2
Timestamp: 1408710653491
Nonce:14314
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: Application/x-www-form-urlencoded

HTTP 响应:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "code":200,
  "objectNames":["RC:ImgMsg","RC:ImgTextMsg","RC:VcMsg"]
}