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[] 字段与请求属性项一致,但以服务端最终生效的值为准。