通过邮件查询顾客信息

需要 read_customers 权限点。

更多权限点使用信息，请参考：

POST https://{handle}.myshopline.com/admin/openapi/v20260301/customers/query_user_by_email.json

handle ：店铺的唯一标识符，值为店铺域名的前缀。例如，域名为 open001.myshopline.com 的店铺，其 handle 是 open001 。

通过邮箱查询客户详情。

请求头

Content-Type string required

字段值固定为 application/json; charset=utf-8。
Authorization string required

资源的访问令牌。参考应用授权获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入。
例子:

Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw

请求体

email string required

用户邮箱
例子: *******@example.com

状态码

更多状态码信息，参考 HTTP 状态码。

响应头

traceId

请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。

响应体

customerobject

客户详情
accepts_marketing boolean

是否邮件订阅
例子: true
accepts_marketing_updated_at string

邮件订阅时间（格式见IOS8601）
例子: 2022-05-31T15:32:46+08:00
accepts_mobile_marketing boolean

是否接受电话营销
例子: true
accepts_mobile_marketing_updated_at string

电话订阅时间（格式见IOS8601）
例子: 2022-05-31T15:32:46+08:00
addressesobject[]

地址信息列表
address1 string

地址1
例子: 7720 Cherokee Road
address2 string

地址2
例子: Apartment
city string

城市
例子: Hagerman
company string

公司
例子: C****
country string

国家
例子: United States
country_code string

国家编码
例子: US
customer_id string

客户id
例子: 2277270272
default boolean

是否默认地址
first_name string

名称
例子: S*****
id string

地址id
例子: SL201UA5006511321220969539
last_name string

姓
例子: T*****
phone string

电话号码
例子: 0086158****4475
province string

省
例子: Kentucky
province_code string

省编码
例子: KY
province_code_v2 string

地址的州或省编码，两位的编码缩写（ISO-3166-2格式）
zip string

邮政编码
例子: 40202
asid string

FB登录id
例子: ***********9455
birthday string

客户生日格式为：YYYYMMDD
例子: 19970102
created_at string

创建时间（格式见IOS8601）
例子: 2022-09-07T10:53:31+08:00
currency string

币种
例子: USD
default_addressobject

默认地址
address1 string

地址1
例子: 7720 Cherokee Road
address2 string

地址2
例子: Apartment 2
city string

城市
例子: Hagerman
company string

公司
例子: C****
country string

国家
例子: United States
country_code string

国家编码
例子: US
customer_id string

客户id
例子: 2277270272
default boolean

是否默认地址
first_name string

名称
例子: T*****
id string

地址id
例子: SL201UA5006511323520969534
last_name string

姓
例子: S*****
phone string

电话号码
例子: 0086158****4475
province string

省
例子: Kentucky
province_code string

省编码
例子: KY
province_code_v2 string

地址的州或省编码，两位的编码缩写（ISO-3166-2格式）
例子: KY
zip string

邮政编码
例子: 40202
email string

邮箱
例子: ******@example.com
email_subscribe_flag integer

邮箱订阅状态 0:取消订阅，1:已订阅，2:未订阅
例子: 1
first_name string

用户名字
例子: S*****
gender string

性别：male / female / others/secret
例子: female
id string

客户id
例子: 2277270272
language string

客户所用语言
例子: en
last_name string

用户姓氏
例子: T*****
last_order_id string

最近一笔订单号
例子: 2005473211984312275741
mobile_subscribe_flag integer

手机订阅状态0:取消订阅，1:已订阅，2:未订阅
nick_name string

昵称
例子: S***** T*****
note string

备注
例子: mark
orders_count long

订单数量
例子: 12
phone string

手机号
例子: 0086158****4475
social_customer array

社媒用户id
例子: ["************5231"]
state integer

客户状态【0 : 已禁用账户，1：待启用账户，2：已邀请账户，3：有效账户】
例子: 2
tags string

客户标签
例子: loyal
total_spent string

总花费金额
例子: 100
updated_at string

更新时间（格式见IOS8601）
例子: 2022-09-07T10:53:31+08:00
verified_email boolean

是否验证邮件

API Explorer

调试台

Base URL

https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

Authorization — header required

Body

Body required

{
  "email": "*******@example.com"
}

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/customers/query_user_by_email.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'

这篇文章对你有帮助吗？

SHOPLINE

条款协议