https://xxxxxx/v4/openim/get_c2c_unread_msg_num?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
Parameter | Description |
xxxxxx | Domain name corresponding to the country/region where your SDKAppID is located. China: console.tim.qq.com Singapore: adminapisgp.im.qcloud.com Seoul: adminapikr.im.qcloud.com Frankfurt: adminapiger.im.qcloud.com Silicon Valley: adminapiusa.im.qcloud.com Jakarta: adminapiidn.im.qcloud.com |
v4/openim/get_c2c_unread_msg_num | Request API |
sdkappid | SDKAppID assigned by the Chat console when an app is created |
identifier | |
usersig | |
random | A random 32-bit unsigned integer ranging from 0 to 4294967295. |
contenttype | Request format, which should always be json . |
dramon1
. Only To_Account
is required.{"To_Account":"dramon1"}
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 0,"AllC2CUnreadMsgNum": 12}
dramon1
's conversations with dramon2
and teacher
.{"To_Account":"dramon1","Peer_Account":["dramon2","teacher"]}
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 0,"C2CUnreadMsgNumList": [{"Peer_Account": "dramon2","C2CUnreadMsgNum": 12},{"Peer_Account": "teacher","C2CUnreadMsgNum": 12}]}
Field | Type | Required | Description |
To_Account | String | Yes | UserID of the user to query |
Peer_Account | Array | No | UserID of the other party in the conversation to queryThis field is required to query a specific one-to-one conversation. The array can contain up to 10 UserID values. |
Field | Type | Description |
ActionStatus | String | Request result. OK : Successful; FAIL : Failed |
ErrorCode | Integer | Error code. 0 : Successful; other values: Failed |
ErrorInfo | String | Error information |
AllC2CUnreadMsgNum | Integer | Total unread message count of all conversations |
C2CUnreadMsgNumList.Peer_Account | String | UserID of the other party in the one-to-one conversation |
C2CUnreadMsgNumList.C2CUnreadMsgNum | Integer | Unread message count in the one-to-one conversation |
ErrorList.Peer_Account | String | Target account for which the query failed |
ErrorList.ErrorCode | Integer | Error code. 70107 indicates that the account does not exist. |
ErrorCode
and ErrorInfo
respectively.
For public error codes (60000 to 79999), see Error Codes.
The following table describes the error codes specific to this API:Error Code | Description |
90001 | Failed to parse the JSON request. Make sure the format is valid. |
90003 | The To_Account field is missing in the JSON request, or the account specified by To_Account does not exist. |
90008 | The From_Account field is missing in the JSON request, or the account specified by From_Account does not exist. |
Was this page helpful?