获取客户标签信息

POST

https://qiyukf.com/openapi/tag/all

该接口由七鱼提供。通过该接口可以获取所有访客标签信息。第三方在获取到访客标签信息后，需要将标签信息存储到本地库中，以便后续标签信息同步时可以快速根据标签id找到对应标签名字。标签同步事件中传递的信息，只有标签id，没有标签名字。

请求body内容固定为all，示例如下：

all

接口调用及数据校验规则参考上面营销接口调用及校验

当code=200时，result内容为JsonArray数据，格式如下：

[
    {
        "id":156656,
        "name":"重点客户",
        "color":"#eeeeee"
    },{
        "id":2455485,
        "name":"新客户",
        "color":"#dddddd"
    }
]

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qiyukf.com/openapi/tag/all?appKey=&time=&checksum=' \
--header 'Content-Type: application/json' \
--data-raw 'all'

响应示例

{
  "result": [
    {
      "id": 0,
      "name": "string",
      "color": "string"
    }
  ],
  "code": 0,
  "message": "string"
}

请求参数

Query 参数

appKey

string

必需

企业的appKey，1064deea1c3624c9ee26d1de5ce8481f

默认值:

time

string

必需

当前 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数,1463217187

默认值:

checksum

string

必需

SHA1(appSecret + md5 + time), 三个参数拼接的字符串，进行SHA1哈希计算，转化成16进制字符(String，小写).示例2f13932c4b7c6888b12360a85261a11b8b543f64

默认值:

Body 参数application/json

string

可选

示例

返回响应

🟢200成功

application/json

Body

result

array [object {3}]

认证结果

必需

integer

必需

name

string

必需

color

string

必需

code

integer

必需

错误码。200表示设置成功。

message

string

错误提示信息

必需

修改于 2022-01-28 04:25:15

概览

修改客户标签