# 商户获取客户绑定的电商账号列表
请求方式:POST
请求地址:https://$basehost/gateway/eaopen/GetContactBindList
body参数:
{
"offset": 0,
"limit": 10,
"union_id_list": ["客户1微信union_id", "客户2微信union_id"],
"external_user_id_list": ["客户1企微external_user_id"],
"start_time": 0,
"end_time": 0
}
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
offset | int | 是 | 每次获取的的开始位置,最小值为0 |
limit | int | 是 | 每次获取的条数,取值范围(1~100) |
union_id_list | array | 否 | 查询指定客户微信union_id列表 |
external_user_id_list | array | 否 | 查询指定客户企微external_user_id列表 |
start_time | int | 否 | 绑定更新时间-起始时间戳 |
end_time | int | 否 | 绑定更新时间-结束时间戳 |
返回值:
{
"data": {
"list": [
{
"union_id": "微信union_id",
"type": 1,
"value": "",
"is_cancel": false,
"buyer_account": null,
"bind_update_time": 0,
"external_user_id": "",
"account_id": ""
}
],
"has_more": true
},
"errcode": 0,
"errmsg": "",
"hint": ""
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
data | json | json返回值 |
data.has_more | bool | 是否有下一页 |
data.list | array | 绑定关系列表 |
data.list[x].union_id | string | 微信union_id,可能为空 |
data.list[x].type | int | 1是手机号,2是电商账号,3是union_id |
data.list[x].value | int | type=1时,值为手机号,type=3时,值为union_id |
data.list[x].is_cancel | bool | true已取消 false未取消 |
data.list[x].account_id | string | 内部客户id,可能为空 |
data.list[x].bind_update_time | int | 绑定关系更新时间戳 |
data.list[x].external_user_id | string | 微信external_user_id |
data.list[x].buyer_account | object | 电商账号信息,type=2时有值 |
errcode | int | 状态码,0为正常,非0代表错误 |
errmsg | string | 错误信息 |
hint | string | 请求日志ID |
buyer_account说明:
字段 | 类型 | 说明 |
---|---|---|
channel | int | 1淘宝、2自建、3有赞、4抖店、5快手、6淘宝线下、7爱库存、8线下门店 |
open_id | string | 各电商账号内部id |
完整请求示例:
curl -X POST \
https://$basehost/gateway/eaopen/GetContactBindList \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{
"offset": 0,
"limit": 10,
"union_id_list": ["客户1微信union_id", "客户2微信union_id"],
"start_time": 0,
"end_time": 0
}'