The app backend uses this callback to view information about users added to the blocklist in real time.
The callback is triggered when the IM backend receives a request for adding a user to the blocklist and successfully adds the user to the blocklist.
In the following example, the callback URL configured in the app is https://www.example.com
.
Example:
https://www.example.com?SdkAppid=$SDKAppID&CallbackCommand=$CallbackCommand&contenttype=json&ClientIP=$ClientIP&OptPlatform=$OptPlatform
Parameter | Description |
---|---|
https | The request protocol is HTTPS, and the request method is POST. |
www.example.com | The callback URL. |
SdkAppid | The SDKAppID assigned by the IM console when an app is created. |
CallbackCommand | The value is fixed to Sns.CallbackBlackListAdd. |
contenttype | The value is fixed to JSON. |
ClientIP | The client IP address, whose format is similar to: 127.0.0.1. |
OptPlatform | The client platform. For details on the possible values, see the OptPlatform parameter in Third-Party Callback Overview: Callback Protocols. |
{
"CallbackCommand": "Sns.CallbackBlackListAdd",
"PairList": [
{
"From_Account": "id",
"To_Account": "id1"
},
{
"From_Account": "id",
"To_Account": "id2"
},
{
"From_Account": "id",
"To_Account": "id3"
}
]
}
Field | Type | Description |
---|---|---|
CallbackCommand | String | The callback command. |
PairList | Array | The blocklist relationship chain pair that is successfully added. |
From_Account | String | From_Account adds To_Account to the blocklist. |
To_Account | String | To_Account is added to the blocklist of From_Account. |
{
"ActionStatus": "OK",
"ErrorCode": 0,
"ErrorInfo": ""
}
Field | Type | Attribute | Description |
---|---|---|---|
ActionStatus | String | Required | The request processing result. OK: succeeded. FAIL: failed. |
ErrorCode | Integer | Required | The error code. 0 indicates that the app backend processing succeeded, and 1 indicates that the app backend processing failed. |
ErrorInfo | String | Required | Error information. |
Was this page helpful?