Skip to content

同步访客扩展属性

POST /visitor/data/attributes

按商户配置写入当前访客的长期属性。接口返回经过服务端校验、策略合并和展示标准化后的属性集。

请求参数

字段位置类型必填用途
visitor_attributesbodyarray访客属性数组。
attribute_modebodystring合并模式;默认 merge

visitor_attributes[]

字段类型必填用途
keystring小写字母开头的属性机器名,最长 64 位。
labelstring属性展示名称。
typestring属性类型,默认 text
valuestring | number | boolean | null属性值,不能是对象或数组。
editableboolean是否可由客服编辑;图片属性会被服务端固定为 false

成功响应

json
{
  "code": 0,
  "msg": "ok",
  "data": {
    "attributes": [
      { "key": "<属性名>", "label": "<属性标签>", "type": "text", "value": "<属性值>", "editable": false }
    ]
  }
}

data.attributes[] 字段与请求属性项一致,但以服务端最终生效的值为准。