https://xxxxxx/v4/openim_msg_ext_http_svc/get_key_values?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_msg_ext_http_svc/get_key_values | 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 . |
MsgKey
is 44739199_12_1665388280
:{"From_Account": "62768","To_Account": "116400","MsgKey": "44739199_12_1665388280"}
MsgKey
is 44739199_12_1665388280
and Seq
is greater than or equal to 2:{"From_Account": "62768","To_Account": "116400","MsgKey": "44739199_12_1665388280","StartSeq": 2}
Field | Type | Required | Description |
From_Account | String | No | UserID of the sender (used to specify the message sender) |
To_Account | String | Yes | UserID of the recipient |
MsgKey | String | Yes | Unique identifier of the one-to-one message. For how to obtain the MsgKey of the message, see the API for sending one-to-one messages to one user. |
StartSeq | Integer | No | Message extension will be pulled for messages whose Seq is greater than or equal to StartSeq . |
{"ErrorCode": 0,"ErrorInfo": "","ActionStatus": "OK","CompleteFlag": 1,"LatestSeq": 2,"ClearSeq": 0,"ExtensionList": [{"Key": "k1","Value": "v1","Seq": 1},{"Key": "k2","Value": "v2","Seq": 1},{"Key": "k3","Value": "v3","Seq": 2}]}
Field | Type | Description |
ActionStatus | String | Request result. OK : successful. FAIL : failed |
ErrorCode | Integer | Error code. 0 : Successful. Other values: Failed |
ErrorInfo | String | Error information |
ExtensionList | Array | List of key-value pairs returned, where the key-value pairs are sorted by Seq . Up to 200 key-value pairs can be returned per pull. If there are more than 200 key-value pairs, they need to be pulled in batches based on StartSeq . |
CompleteFlag | Integer | 1 : All key-value pairs are returned. 0 : Not all key-value pairs are returned. |
LatestSeq | Integer | Latest Seq of the backend, which is the maximum value of Seq among all key-value pairs. |
ClearSeq | Integer | Seq for the clearing operation. All key-value pairs whose Seq is less than or equal to ClearSeq must be deleted locally on the client. |
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 |
10002 | Internal server error. Try again. |
10004 | Invalid parameter. Check the error description and troubleshoot the issue. |
10008 | Invalid request: The request is not an Premium edition plan request. |
23004 | The one-to-one message does not exist. |
Was this page helpful?