客户管理
查询全部客户标签
查询企业下所有客户标签,包括标签 ID、名称和颜色。建议第三方将标签 ID、名称等信息缓存到本地,用于后续标签同步事件中根据标签 ID 反查名称。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳(秒) | |
| checksum | string | 是 | 请求签名校验和 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| message | string | 提示信息 | |
| result | object[] | 标签列表 | |
| └id | int64 | 标签 ID | 1001 |
| └name | string | 标签名称 | VIP客户 |
| └color | string | 标签颜色 | #FF5733 |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14500 | 服务内部异常 |
| 14515 | 企业未开通客户标签服务 |
postEndpoint
/openapi/tag/allcurl -X POST "https://qiyukf.com/openapi/tag/all?appKey=string&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef"{
"code": 200,
"message": "string",
"result": [
{
"id": 1001,
"name": "VIP客户",
"color": "#FF5733"
}
]
}{
"code": 14001,
"message": "AppKey 不存在"
}{
"code": 14002,
"message": "checksum 校验失败"
}{
"code": 14003,
"message": "请求时间戳与服务器时间误差超过 10 分钟"
}{
"code": 14500,
"message": "服务内部异常"
}{
"code": 14515,
"message": "企业未开通客户标签服务"
}这篇文档有帮助吗?