# 删除客户好友
[异步回调] 删除客户好友
机器人可删除的仅只有客户好友。
温馨提示:扫码号移动端删除好友,也会有回调推送。但当机器人被好友删除后,机器人移动端删除好友。针对此类情况因企业微信暂无法感知所以无回调 。
请求方式:POST
请求地址:https://$basehost/gateway/qopen/DeleteContact
body参数:
{
"robot_id":"机器人id",
"contact_id":"客户id",
}
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
robot_id | string | 是 | 机器人id |
contact_id | string | 是 | 客户id |
返回值:
{
"data": {
"serial_no": "操作序列号"
},
"errcode": 0,
"errmsg": "",
"hint": ""
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
errcode | int | 状态码,0为正常,非0代表错误 |
errmsg | string | 错误信息 |
data | json | json返回值 |
serial_no | string | 请求序列号 |
hint | string | 请求日志ID |
处理结果,异步返回值 encoding_content解密后的结构:
{
"event_type": 200011,
"err_code": 0,
"err_msg": "",
"serial_no": "请求序列号",
"robot_id": "机器人id",
"data": {
"contact_id": "被删除的好友id"
}
}
字段 | 类型 | 说明 |
---|---|---|
event_type | int | 事件类型,200011 |
err_code | int | 状态码,0为正常,非0代表错误 |
err_msg | string | 错误信息 |
serial_no | string | 请求序列号 |
robot_id | string | 机器人id |
data | object | 返回数据 |
data.contact_id | string | 被删除的好友id |
完整请求示例:
curl -X POST \
https://$basehost/gateway/qopen/DeleteContact \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{
"robot_id":"机器人id",
"contact_id":"客户id",
}'