# 客户

> Shoplazza CLI 的 customers 命令：+search 快捷命令，以及创建、更新和管理客户资料与收货地址的 API 命令。

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

## 快捷命令

### +search

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

```shell
shoplazza customers +search [flags]
```

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

```shell
shoplazza customers +search
shoplazza customers +search --email test@example.com
shoplazza customers +search --phone "+1234567890"
shoplazza customers +search --since 2026-01-01 --page-limit 50
```

### +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 test@example.com
shoplazza customers +create --phone "+1234567890"
shoplazza customers +create --email test@example.com --first-name John --last-name Doe \
  --tags "vip,wholesale"
```

## API 命令

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

| 参数 | 短参 | 说明 |
|------|------|------|
| `--params` | | 路径/查询参数（JSON 格式） |
| `--data` | | 请求体（JSON 格式） |
| `--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
```