七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
客户管理

查询全部客户标签

查询企业下所有客户标签,包括标签 ID、名称和颜色。建议第三方将标签 ID、名称等信息缓存到本地,用于后续标签同步事件中根据标签 ID 反查名称。

请求参数

名称类型必填描述示例值
appKeystring是应用 AppKey
timeint64是请求时间戳(秒)
checksumstring是请求签名校验和

返回参数

名称类型描述示例值
codeint32状态码,200 表示成功200
messagestring提示信息
resultobject[]标签列表
└idint64标签 ID1001
└namestring标签名称VIP客户
└colorstring标签颜色#FF5733

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14500服务内部异常
14515企业未开通客户标签服务
postEndpoint
/openapi/tag/all
POST
/openapi/tag/all
curl -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": "企业未开通客户标签服务"
}

这篇文档有帮助吗?