客户

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

快捷命令

+search

按邮箱、电话或日期范围搜索客户。

shoplazza customers +search [flags]

参数	类型	说明
--email	string	按邮箱过滤
--phone	string	按电话过滤
--since	string	开始时间
--until	string	结束时间
--page-limit	int	页面大小（1–250）
--fields	string	返回字段（逗号分隔）

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

+create

创建客户。

shoplazza customers +create [flags]

参数	类型	说明
--email	string	邮箱（--email 或 --phone 二选一）
--phone	string	电话（--email 或 --phone 二选一）
--first-name	string	名
--last-name	string	姓
--tags	string	标签（逗号分隔）
--no-marketing	bool	不订阅营销（默认订阅）

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 格式）
--jq	-q	jq 表达式过滤输出
--dry-run		预览请求，不实际执行

customers

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

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 自省

shoplazza schema customers
shoplazza schema customers.addresses.create