接口说明:获取客户列表,分页获得企业下的客户Id
限制说明:允许两秒请求一次,否则返回:操作频繁,请稍后重试
应用权限: 用户→用户资料
访问路径:/api/audience/user/id/list
Type: GET
Author: zhuyanpeng
Content-Type: application/x-www-form-urlencoded;charset=utf-8
Description: 获取客户列表
Query-parameters:
Parameter | Type | Required | Description |
---|---|---|---|
audienceUserId | int64 | false | 客户Id,根据Id升序获取后续数据,首次无Id则不传客户Id,根据Id升序获取后续数据,首次无Id则不传 |
size | int32 | false | 数量,默认为10000,最大10000 |
Response-fields:
Field | Type | Description |
---|---|---|
code | string | 状态码 |
errorCode | string | 错误状态码 |
msg | string | 状态描述 |
data | object | 数据 |
└─orgId | string | 企业id |
└─audienceUserIdList | array | 客户档案id集合 |
请求示例
换行和缩进只是为了更好的展示:
https://数据集成域名/api/audience/user/id/list
返回成功示例
1、首次请求audienceUserId为空,按照id升序返回前5条
https://系统集成域名/api/audience/user/id/list?size=5
{ "code":"200", "errorCode":"SUCCESS", "msg":"ok", "data":{ "orgId":"928a852d-e749-45be-bc31-f8e23f07b999", "audienceUserIdList":[ "1", "2", "3", "4", "5" ] } }
2、继续获取后5条数据,使用最后一个id:5(两次请求即可返回前10条数据)
https://系统集成域名/api/audience/user/id/list?audienceUserId=5&size=5
{ "code":"200", "errorCode":"SUCCESS", "msg":"ok", "data":{ "orgId":"928a852d-e749-45be-bc31-f8e23f07b999", "audienceUserIdList":[ "6", "7", "8", "9", "10" ] } }
3、不传size 示例,如果有数据,则返回10000条
https://系统集成域名/api/audience/user/id/list
{ "code":"200", "errorCode":"SUCCESS", "msg":"ok", "data":{ "orgId":"928a852d-e749-45be-bc31-f8e23f07b999", "audienceUserIdList":[ "1", "2", "3", "4", "5", "6", "...", "10000" ] } }