## 用户级默认配置 (`user-defaults`)

新建站点或四层转发时带入的默认字段,按类型分别保存。

鉴权: 用户 · 文档: https://www.gocdn888.com/zh/docs/api/user-defaults

### GET `/api/v2/user-defaults/{kind}`

获取用户级默认配置 · 鉴权: 用户

```sh
curl "https://panel.example.com/api/v2/user-defaults/{kind}" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### PUT `/api/v2/user-defaults/{kind}`

修改用户级默认配置 · 鉴权: 用户

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `expected_updated_at` | string |  | 乐观锁:调用方读到的 updated_at(读到 updated_at 为空 = 还没设置过,用 1970-01-01T00:00:00Z)。与库里当前值不等则回 409 stale_version、不保存;不带则不检查。 |
| `value` | object | 有 | 默认字段(站点/四层契约的顶层字段子集)。 |

```sh
curl -X PUT "https://panel.example.com/api/v2/user-defaults/{kind}" \
  -H "X-API-Key: $GOCDN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value":{"balance":"rr","origin_timeout_s":60}}'
```

### DELETE `/api/v2/user-defaults/{kind}`

清空用户级默认配置 · 鉴权: 用户

```sh
curl -X DELETE "https://panel.example.com/api/v2/user-defaults/{kind}" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

用户级默认配置对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `expected_updated_at` | string |  | 乐观锁:调用方读到的 updated_at(读到 updated_at 为空 = 还没设置过,用 1970-01-01T00:00:00Z)。与库里当前值不等则回 409 stale_version、不保存;不带则不检查。 |
| `kind` | string |  | 默认配置类型:site 站点;stream 四层转发。 可选值: ["site","stream"] |
| `updated_at` | string |  | 更新时间 |
| `value` | object |  | 默认字段(站点/四层契约的顶层字段子集)。 |
