事件分组事件标识
customerscustomers/update
客户更新
请求头
  • X-Shopline-Topic string required
    事件的唯一标识。
    例子: orders/edited
  • X-Shopline-Hmac-Sha256 string required
    该请求的签名。收到请求后,你需要对该签名进行 验签 以验证数据的真实性和完整性。
    例子: XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM=
  • X-Shopline-Shop-Domain string required
    店铺的域名。
    例子: example.myshopline.com
  • X-Shopline-Shop-Id string required
    店铺 ID。
    例子: 1610418123456
  • X-Shopline-Merchant-Id string required
    商家 ID。
    例子: 2000001234
  • X-Shopline-API-Version string required
    API 版本号。
    例子: v20250601
  • X-Shopline-Webhook-Id string required
    该 Webhook 事件的 ID。
    例子: b54557e48a5fbf7d70bcd043
请求体
  • accepts_marketing boolean
    是否订阅邮件
    例子: true
  • accepts_marketing_updated_at string
    邮箱订阅时间
    例子: 2022-12-16T11:06:11+08:00
  • accepts_mobile_marketing boolean
    是否接受电话营销
    例子: true
  • accepts_mobile_marketing_updated_at string
    电话订阅时间(格式见IOS8601)
    例子: 2022-12-16T11:06:11+08:00
  • addressesobject[]
    地址信息列表
  • address1 string
    地址1
    例子: 7720 Cherokee Road
  • address2 string
    地址2
    例子: Apartment
  • city string
    城市
    例子: Hagerman
  • company string
    公司
    例子: Joyy
  • country string
    国家
    例子: United States
  • country_code string
    国家编码
    例子: US
  • customer_id string
    客户id
    例子: 200093842
  • default boolean
    是否默认地址
    例子: true
  • first_name string
    名称
    例子: Bob
  • id string
    地址id
    例子: SL201UA5006511321220969539
  • last_name string
    例子: James
  • phone string
    手机号
    例子: 008613978653472
  • province string
    例子: Kentucky
  • province_code string
    省编码
    例子: KY
  • zip string
    邮政编码
    例子: 40202
  • asid string
    FB登录id
    例子: 542132312312323
  • birthday string
    客户生日 格式为:YYYYMMDD
    例子: 19900625
  • created_at string
    创建时间
    例子: 2022-12-16T11:06:11+08:00
  • currency string
    币种
    例子: CNY
  • default_addressobject
    默认地址
  • address1 string
    地址1
    例子: 7720 Cherokee Road
  • address2 string
    地址2
    例子: Apartment
  • city string
    城市
    例子: Hagerman
  • company string
    公司
    例子: Joyy
  • country string
    国家
    例子: United States
  • country_code string
    国家编码
    例子: US
  • customer_id string
    客户id
    例子: 200838473
  • default boolean
    是否默认地址
    例子: true
  • first_name string
    名称
    例子: Bob
  • id string
    地址id
    例子: SL201UA5006511321220969539
  • last_name string
    例子: James
  • phone string
    手机号
    例子: 008613965748321
  • province string
    例子: Kentucky
  • province_code string
    省编码
    例子: KY
  • zip string
    邮政编码
    例子: 40202
  • email string
    邮箱
    例子: gungcherny@gamil.com
  • email_marketing_consentobject
    邮件营销订阅信息
  • consent_collected_from string
    订阅信息来源
    例子: Subscription information source
  • consent_updated_at string
    订阅变更时间
    例子: 2022-12-16T11:06:11+08:00
  • opt_in_level integer
    订阅方式(0
    ;1
    ;2
    )
    例子: 2
  • state integer
    订阅状态(0:取消订阅;1:已订阅;2:未订阅;3:订阅确认中)
    例子: 2
  • email_subscribe_flag integer
    邮箱订阅状态 0:取消订阅,1:已订阅,2:未订阅
    例子: 2
  • first_name string
    名字
    例子: Bob
  • gender string
    性别:male / female / others/secret
    例子: male
  • id string
    客户id
    例子: 231321312321
  • language string
    客户所用语言
    例子: en
  • last_name string
    姓氏
    例子: James
  • last_order_id string
    最近一笔订单号
    例子: 200832869120938
  • mobile_subscribe_flag integer
    手机订阅状态0:取消订阅,1:已订阅,2:未订阅
    例子: 2
  • multipass_identifier string
    multipass标识
    例子: multipass_identifier
  • nick_name string
    用户昵称
    例子: Bob James
  • note string
    备注
    例子: test
  • orders_count long
    订单数量
    例子: 4223
  • phone string
    手机号
    例子: 008613987864352
  • sms_marketing_consentobject
    短信营销订阅信息
  • consent_collected_from string
    订阅信息来源
    例子: Subscription information source
  • consent_updated_at string
    订阅变更时间
    例子: 2022-12-16T11:06:11+08:00
  • opt_in_level integer
    订阅方式(0
    ;1
    ;2
    )
    例子: 1
  • state integer
    订阅状态(0:取消订阅;1:已订阅;2:未订阅)
    例子: 1
  • social_customer string
    社媒用户id
    例子: 43245645353245
  • state integer
    客户状态【0 : 已禁用账户,1:待启用账户,2:已邀请账户,3:有效账户】
    例子: 2
  • tags string
    客户标签
    例子: good
  • total_spent string
    总花费金额
    例子: 324324
  • updated_at string
    更新时间
    例子: 2022-12-16T11:06:11+08:00
  • verified_email boolean
    是否验证邮件
    例子: true
状态码
收到 SHOPLINE 发送的 Webhook 通知后,你需要按照如下 SHOPLINE 要求的格式进行响应。
HTTP/1.1 200 OK
关于如何订阅 Webhooks 及更多 Webhook 响应规则说明,请参考 Webhook 概述
这篇文章对你有帮助吗?