查询客户分组下的所有顾客

需要 read_customers 权限点。
更多权限点使用信息，请参考：
访问权限。
GET https://{handle}.myshopline.com/admin/openapi/v20260301/customer_saved_searches/:id/customers.json
handle ：店铺的唯一标识符，值为店铺域名的前缀。例如，域名为 open001.myshopline.com 的店铺，其 handle 是 open001 。
查询某个分组下的客户列表
路径参数
  • id string required
    分组id
    例子: GROUP5702780975899485252
查询参数
  • order string
    排序规则 1：根据最后下单时间倒序（默认） 2：根据订单数倒序
    例子: 1
  • page_info string
    分页查询的唯一标识，用于定位特定页面。
    该字段值需要在你已经查询完分页信息后，在该接口响应头中的 link 字段值中获取。例如，你获取到的 link 的值为 <https://{handle}.myshopline.com/admin/openapi/{version}/customer_saved_searches/:id/customers.json?limit=1&page_info=eyJzaW5jZUlkIjoiMTYwNTc1OTAxNTM4OTA4Mjk1MjExMTI3ODgiLCJkaXJlY3Rpb24iOiJuZXh0IiwibGltaXQiOjF9>; rel="next" ，那么 page_info 的值为 eyJzaW5jZUlkIjoiMTYwNTc1OTAxNTM4OTA4Mjk1MjExMTI3ODgiLCJkaXJlY3Rpb24iOiJuZXh0IiwibGltaXQiOjF9 。
    关于更多如何使用分页信息，请参考 分页机制。
    例子: eyJxdWVyeVBhcmFtU3RyaW5nIjoie1wic2l6ZVwiOjEsXCJzb3J0XCI6W1widWlkOmRlc2NcIl0sXCJzdG9yZUlkXCI6XCIxNjM5NjQwNTgxMzQ2XCIsXCJ1aWRcIjpcIjBcIixcImNyZWF0ZVRpbWVcIjpcIjw9MTY0OTg1NTYwMDAwMFwiLFwidXBkYXRlVGltZVwiOlwiXCJ9Iiwic2luY2VJZExpc3QiOlsiNDIwMTY4MDE5NSJdLCJwYWdlIjoyLCJzaXplIjoxLCJpbml0U29ydCI6WyJ1aWQ6ZGVzYyJdLCJzb3J0IjpbInVpZDpkZXNjIl0sImRpcmVjdGlvbiI6Im5leHQifQ
  • fields string
    限定返回的对象的字段
    例子: id
  • limit string
    查询数量限制，默认50，不能超过250
    例子: 10
请求头
  • Content-Type string required
    字段值固定为 application/json; charset=utf-8。
  • Authorization string required
    资源的访问令牌。参考 应用授权 获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入。
    例子:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
状态码
更多状态码信息，参考 HTTP 状态码。
响应头
  • link
    提供分页数据的 URL 链接。你可以获取该字段值中的 page_info 信息用于下一次分页请求中。
    当你请求的页面存在上一页或下一页的时候，该字段会被返回。关于更多如何使用分页信息，请参考 分页机制。
  • traceId
    请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。
响应体
  • customersobject[]
    客户列表
  • accepts_marketing boolean
    是否接受邮件营销
    例子: true
  • accepts_marketing_updated_at string
    邮件订阅时间
    例子: 2022-05-31T15:32:46+08:00
  • addressesobject[]
    客户地址列表
  • address1 string
    地址1
    例子: 7720 Cherokee Road
  • address2 string
    地址2
    例子: Apartment 2
  • city string
    三级地址
    例子: Hagerman
  • country string
    一级地址
    例子: United States
  • country_code string
    一级地址编码
    例子: US
  • customer_id string
    使用该地址的客户id
    例子: 4201825054
  • default boolean
    是否是默认地址
    例子: true
  • first_name string
    客户的名
    例子: Bob
  • id string
    地址id
    例子: 207119551
  • last_name string
    客户的姓
    例子: Norman
  • phone string
    电话号码
    例子: 008615834564475
  • province string
    二级地址
    例子: Kentucky
  • province_code string
    二级地址编码
    例子: KY
  • zip string
    邮编
    例子: 40202
  • created_at string
    客户信息创建于
    例子: 2022-09-07T10:53:31+08:00
  • currency string
    币种
    例子: USD
  • email string
    邮件
    例子: 123@qq.com
  • email_subscribe_flag integer
    邮箱订阅状态 0:取消订阅，1:已订阅，2:未订阅，3:确认中，4:无效，5:被删除
    例子: 1
  • first_name string
    客户用户名
    例子: Bob
  • id string
    客户id
    例子: 4201825054
  • last_name string
    客户用户名
    例子: Norman
  • last_order_id string
    最近一笔订单号
    例子: 2005473211984312275741
  • last_order_name string
    最近一笔订单名称
    例子: order1
  • last_order_time string
    最近一笔订单时间
    例子: 2022-09-07T10:53:31+08:00
  • mobile_subscribe_flag string
    手机订阅状态 0:取消订阅，1:已订阅，2:未订阅，3:确认中，4:无效，5:被删除
    例子: 1
  • nick_name string
    用户全名
    例子: Bob Norman
  • note string
    客户备注
    例子: Placed an order that had a fraud warning
  • orders_count long
    客户累计订单数
    例子: 12
  • phone string
    手机号
    例子: 008615834564475
  • state integer
    客户状态。0 已禁用账户；1 待启用账户；2 已邀请账户；3 有效账户
    例子: 2
  • tags string
    客户标签 英文逗号拼接
    例子: loyal
  • total_spent string
    客户累计消费金额
    例子: 100
  • updated_at string
    客户信息更新于
    例子: 2022-09-07T10:53:31+08:00
  • verified_email boolean
    是否验证邮件
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

— path required
— header required
— query
— query
— query
— query

Language

curl --request GET \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/customer_saved_searches/id/customers.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'
Examples
查询分组下用户
Response
{
  "customers": [
    {
      "accepts_marketing": false,
      "addresses": [],
      "created_at": "2023-04-12T15:54:10+08:00",
      "email": "******@example.com",
      "email_subscribe_flag": 2,
      "first_name": "S*****",
      "id": "4214250090",
      "last_name": "T*****",
      "mobile_subscribe_flag": 1,
      "nick_name": "S***** T*****",
      "orders_count": 2,
      "phone": "0086138****5678",
      "state": 1,
      "total_spent": "800",
      "updated_at": "2023-04-13T22:53:48+08:00"
    }
  ]
}
这篇文章对你有帮助吗？
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
条款协议
隐私
条款
开发者协议
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.