# 通过unionid查询客户Id
请求方式:POST
请求地址:https://$basehost/gateway/qopen/BatchGetContactIdByUnionId
body参数:
{
"union_id_list": "unionid列表"
}
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
union_id_list | array | 是 | 客户union_id列表,最小长度为1,最大长度为100 |
返回值:
{
"data": {
"id_map": [
{
"union_id1": "ql客户id1",
"union_id2": "ql客户id2"
}
],
"failed_list": []
},
"errcode": 0,
"errmsg": "",
"hint": ""
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
errcode | int | 状态码,0为正常,非0代表错误 |
errmsg | string | 错误信息 |
data | json | json返回值 |
id_map | object | key:union_id, value:ql客户id |
failed_list | array | 查询失败的union_id列表 |
hint | string | 请求日志ID |
完整请求示例:
curl -X POST \
https://$basehost/gateway/qopen/BatchGetContactIdByUnionId \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{
"union_id_list": "unionid列表"
}'
← 删除客户好友 异步获取机器人的客户列表 →