# 偏远地区查询

## 接口信息

- Method: `POST`
- URL: `https://tms-go.czl.net/api/v1/remote`
- Auth: `Authorization: Bearer <API_KEY>`
- Content-Type: `application/json`

## 适用场景

- 偏远地区自动判断
- 邮编首查 + 城市补查
- 价格系统中的偏远附加费判定

## 请求体

| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `country_code` | `string` | 是 | 国家二字码，例如 `US`、`NZ` |
| `city_or_post` | `string` | 是 | 城市名或邮编。首查通常传邮编 |
| `selected_city` | `string` | 否 | 用户明确选择的城市名，用于补查 |

## 请求示例

```bash
curl --request POST \
  --url https://tms-go.czl.net/api/v1/remote \
  --header 'Authorization: Bearer your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "country_code": "NZ",
    "city_or_post": "0112",
    "selected_city": "MAIRTOWN"
  }'
```

## 成功响应

```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "query_cities": ["KAMO", "MAIRTOWN", "OTANGAREI"],
    "dhl": {
      "is_remote": false,
      "total_cities": 3
    },
    "fedex": {
      "is_remote": true,
      "remote_type": "TIERB",
      "matched_city": "MAIRTOWN",
      "remote_cities": ["MAIRTOWN"],
      "total_cities": 3
    },
    "ups": {
      "is_remote": false,
      "total_cities": 3
    }
  }
}
```

## 关键字段

- `query_cities`: 邮编对应的候选城市列表
- `is_remote`: 是否偏远
- `remote_type`: 偏远类型
- `matched_city`: 实际命中的城市
- `remote_cities`: 命中的偏远城市列表

## 接入建议

- 推荐先只传 `country_code + city_or_post` 首查
- 如果响应里有 `query_cities`，让用户选择城市后再带 `selected_city` 补查
- 自定义渠道可能会以动态字段名直接出现在 `data` 下