批量修改客户标签

POST

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

该接口由七鱼提供。当有大量的用户标签需要同步到七鱼系统的访客数据时，可以调用该接口，提高更新效率。

请注意：由于该接口依旧是一个同步调用的接口，为了保证接口响应速度，一批修改的客户数据须小于 200 个。同时，该接口调用频次限制为每分钟 60 次。

foreignid 和 mobile 两者必传其中之一，如果两个都传，则以 foreignid 为准。

传入的 JSONArray 允许各种 type 混传，但如果有用户数据重复，例如同时给 mobile1 做了增加，删除和替换的操作，则仅会处理替换请求。增加和删除不互斥，可以同时包含。

所有的更新都是并发执行，不保证执行顺序，如果您的系统中对同一个用户标签数据有多次操作记录，务必做了合并之后，再调用该接口，不能直接将改动记录转换为列表请求。

响应信息为：

当 code=200 时，result 内容为 JsonArray 数据，包含了传入数据里的非法参数，包括不存在用户的 foreignid 列表，不存在用户的 mobile 列表，和不存在的标签 id 列表。非法的数据会被忽略，其他存在的数据则会被正常更新。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qiyukf.com/openapi/tag/batchUpdate?appKey=&time=&checksum=' \
--header 'Content-Type: application/json' \
--data-raw '[
{
    "foreignid": "foreignid1",
    "mobile": "mobile1",
    "tag_ids": [156656,2455485],
    "type": "save"
},
{
    "foreignid": "foreignid2",
    "mobile": "mobile2",
    "tag_ids": [156656,2455485],
    "type": "delete"
},
{
    "foreignid": "foreignid3",
    "mobile": "mobile3",
    "tag_ids": [156656,2455485],
    "type": "replace"
}
]'

响应示例

{
  "foreignIdsNotExist": [
    "foreignid0"
  ],
  "mobilesNotExist": [
    "mobile0"
  ],
  "tagIdsNotExist": [
    1,
    2
  ]
}

请求参数

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

array of:

foreignid

string

必需

访客的foreignid

mobile

string

访客的手机号。

必需

tag_ids

array[integer]

必需

标签id数组，标签id通过/openapi/tag/all接口查询。

type

string

必需

save表示为用户增加对应标签，delete表示从用户标签中删除对应标签, replace表示直接替换原用户的标签数据。

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码。200表示设置成功。其他错误码详见通用错误码列表

message

string

错误提示信息

必需

result

object

必需

传入数据中的非法数据

foreignIdsNotExist

array[string]

必需

该数组中的 foreignid 在七鱼系统中没有对应的客户信息。

mobilesNotExist

array[string]

必需

该数组中的 mobile 在七鱼系统中没有对应的客户信息。

tagIdsNotExist

array[integer]

必需

该数组中的 tagId 在七鱼系统中不存在。

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

修改客户标签

客户标签变更事件