# 好友匹配(通过修改描述)
说明: 当成为好友回调(20001事件)中,无external_user_id时,可调用此接口,修改描述来匹配客户
请求方式:POST
请求地址:https://$basehost/gateway/qopen/MatchAccount
body参数:
{
"robot_id": "机器人id",
"account_id_list": ["客户openid", "客户openid2"]
}
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| robot_id | string | 是 | 机器人 |
| account_id_list | array | 是 | 客户openid |
返回值:
{
"data": {
"match_list": [
{
"account_id": "accIM6YQr3nKTLGH7TJK",
"union_id": "oDE5puNtiu-SK3EDrQpf0Ypj8",
"external_user_id": "wm7_KpDgAA061ieAHyjKCyxgtsm"
}
],
"fail_list": []
},
"errcode": 0,
"errmsg": "",
"hint": "vCSbRqQoVBhhxuT1ingA"
}
| 字段 | 类型 | 说明 |
|---|---|---|
| errcode | int | 错误码 |
| errmsg | string | 错误描述 |
| match_list | list | 已经匹配成功的好友列表 |
| match_list.account_id | string | open_id |
| match_list.union_id | string | union_id |
| match_list.external_user_id | string | 外部联系人id |
| fail_list | list | 匹配失败的好友列表 |
| fail_list.account_id | string | open_id |
| fail_list.union_id | string | union_id |
| fail_list.external_user_id | string | 外部联系人id |
完整请求示例:
curl -X POST \
https://$basehost/gateway/qopen/MatchAccount \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{
"robot_id": "机器人id",
"account_id_list": ["客户openid", "客户openid2"]
}'