客户

管理客户及其地址。包含 3 个快捷命令和 11 个 API 命令。

快捷命令

+search

按邮箱、电话或注册日期范围搜索客户。只返回一页，其余结果按 has_more/cursor 继续翻页。

shell

shoplazza customers +search [flags]

参数	类型	说明
--email	string	按邮箱过滤
--phone	string	按电话过滤（匹配客户的主要联系方式）
--since	string	创建时间下限（ISO 日期或 unix 时间戳）
--until	string	创建时间上限（ISO 日期或 unix 时间戳）
--page-limit	int	页面大小（1–250）

shell

shoplazza customers +search
shoplazza customers +search --email [email protected]
shoplazza customers +search --phone "+1234567890"
shoplazza customers +search --since 2026-01-01 --page-limit 50

+count

统计店铺的全部客户数量。该统计接口不支持过滤；要统计筛选后的子集，请用 +search。

shell

shoplazza customers +count

+create

创建客户。

shell

shoplazza customers +create [flags]

参数	类型	说明
--email	string	邮箱（--email 与 --phone 必须且只能提供其一）
--phone	string	电话（--email 与 --phone 必须且只能提供其一）
--first-name	string	名
--last-name	string	姓
--tags	string	标签（逗号分隔）
--no-marketing	bool	不订阅营销（默认订阅）

shell

shoplazza customers +create --email [email protected]
shoplazza customers +create --phone "+1234567890"
shoplazza customers +create --email [email protected] --first-name John --last-name Doe \
  --tags "vip,wholesale"

API 命令

所有动态 API 命令共享以下参数：

参数	短参	说明
--params		路径/查询参数（JSON 格式）
--data		请求体（JSON 格式，可内联、@file 或 - 读取 stdin）；仅在需要请求体的命令上提供
--jq	-q	jq 表达式过滤输出
--dry-run		预览请求，不实际执行

customers

shell

shoplazza customers list
shoplazza customers get --params '{"customer_id":"123"}'
shoplazza customers create --data @customer.json
shoplazza customers update --params '{"customer_id":"123"}' --data @customer.json
shoplazza customers count

customers addresses

shell

shoplazza customers addresses list --params '{"customer_id":"123"}'
shoplazza customers addresses get --params '{"customer_id":"123","address_id":"456"}'
shoplazza customers addresses create --params '{"customer_id":"123"}' --data @address.json
shoplazza customers addresses update --params '{"customer_id":"123","address_id":"456"}' --data @address.json
shoplazza customers addresses delete --params '{"customer_id":"123","address_id":"456"}'
shoplazza customers addresses set-default --params '{"customer_id":"123","address_id":"456"}'

Schema 自省

shell

shoplazza schema customers
shoplazza schema customers.addresses.create