接口说明:获取客户列表,分页获得企业下的客户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"
]
}
}