通过邮件查询顾客信息

需要 read_customers 权限点。

更多权限点使用信息,请参考:

[]

访问权限

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

[]

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

[]

通过邮箱查询客户详情。

请求头

Content-Type required
[]
字段值固定为application/json; charset=utf-8
Authorization string required
[]
资源的访问令牌。请参考应用授权获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入
Example:
[]
Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw

请求体

email string required
[]
用户邮箱
[]
Example: gungcherny@gamil.com

响应

[]

更多状态码信息请参考 HTTP 状态码

响应头

traceId
[]
traceId

响应体

customerobject
[]
客户详情
accepts_marketing boolean
[]
是否邮件订阅
[]
Example: true
accepts_marketing_updated_at string
[]
邮件订阅时间（格式见IOS8601）
[]
Example: 2022-05-31T15:32:46+08:00
accepts_mobile_marketing boolean
[]
是否接受电话营销
[]
Example: true
accepts_mobile_marketing_updated_at string
[]
电话订阅时间（格式见IOS8601）
[]
Example: 2022-05-31T15:32:46+08:00
addressesobject[]
[]
地址信息列表
address1 string
[]
地址1
[]
Example: 7720 Cherokee Road
address2 string
[]
地址2
[]
Example: Apartment
city string
[]
城市
[]
Example: Hagerman
company string
[]
公司
[]
Example: joyy
country string
[]
国家
[]
Example: United States
country_code string
[]
国家编码
[]
Example: US
customer_id string
[]
客户id
[]
Example: 2277270272
default boolean
[]
是否默认地址
first_name string
[]
名称
[]
Example: maybe
id string
[]
地址id
[]
Example: SL201UA5006511321220969539
last_name string
[]
姓
[]
Example: joho
phone string
[]
电话号码
[]
Example: 008615834564475
province string
[]
省
[]
Example: Kentucky
province_code string
[]
省编码
[]
Example: KY
province_code_v2 string
[]
地址的州或省编码，两位的编码缩写（ISO-3166-2格式）
zip string
[]
邮政编码
[]
Example: 40202
asid string
[]
FB登录id
[]
Example: 481007156599455
birthday string
[]
客户生日格式为：YYYYMMDD
[]
Example: 19970102
created_at string
[]
创建时间（格式见IOS8601）
[]
Example: 2022-09-07T10:53:31+08:00
currency string
[]
币种
[]
Example: USD
default_addressobject
[]
默认地址
address1 string
[]
地址1
[]
Example: 7720 Cherokee Road
address2 string
[]
地址2
[]
Example: Apartment 2
city string
[]
城市
[]
Example: Hagerman
company string
[]
公司
[]
Example: joyy
country string
[]
国家
[]
Example: United States
country_code string
[]
国家编码
[]
Example: US
customer_id string
[]
客户id
[]
Example: 2277270272
default boolean
[]
是否默认地址
first_name string
[]
名称
[]
Example: Bob
id string
[]
地址id
[]
Example: SL201UA5006511323520969534
last_name string
[]
姓
[]
Example: john
phone string
[]
电话号码
[]
Example: 008615834564475
province string
[]
省
[]
Example: Kentucky
province_code string
[]
省编码
[]
Example: KY
province_code_v2 string
[]
地址的州或省编码，两位的编码缩写（ISO-3166-2格式）
[]
Example: KY
zip string
[]
邮政编码
[]
Example: 40202
email string
[]
邮箱
[]
Example: gungcherny2@gamil.com
email_subscribe_flag integer
[]
邮箱订阅状态 0:取消订阅，1:已订阅，2:未订阅
[]
Example: 1
first_name string
[]
用户名字
[]
Example: Bob
gender string
[]
性别：male / female / others/secret
[]
Example: female
id string
[]
客户id
[]
Example: 2277270272
language string
[]
客户所用语言
[]
Example: en
last_name string
[]
用户姓氏
[]
Example: Norman
last_order_id string
[]
最近一笔订单号
[]
Example: 2005473211984312275741
mobile_subscribe_flag integer
[]
手机订阅状态0:取消订阅，1:已订阅，2:未订阅
nick_name string
[]
昵称
[]
Example: nick
note string
[]
备注
[]
Example: mark
orders_count long
[]
订单数量
[]
Example: 12
phone string
[]
手机号
[]
Example: 008615834564475
social_customer array
[]
社媒用户id
[]
Example: 6612273988815231
state integer
[]
客户状态【0 : 已禁用账户，1：待启用账户，2：已邀请账户，3：有效账户】
[]
Example: 2
tags string
[]
客户标签
[]
Example: loyal
total_spent string
[]
总花费金额
[]
Example: 100
updated_at string
[]
更新时间（格式见IOS8601）
[]
Example: 2022-09-07T10:53:31+08:00
verified_email boolean
[]
是否验证邮件

API Explorer

调试台

Base URL

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

ParamOptions

Authorization — header required

Body

Body required

{
  "email": "gungcherny@gamil.com"
}

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601/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

条款协议