<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# 京东地址解析（4 级）

> 调用京东地址智能识别接口，将自然语言地址解析为「省/市/区/镇」四级行政区划，并返回每级对应的京东 ID。比传统三级行政区划接口多一个「镇」级别。

## 1. 基本信息

| 字段 | 值 |
| --- | --- |
| 接口标识 | `jd-address` |
| 接口名称 | 京东地址解析（4 级） |
| 接口地址 | `https://v1.apizero.cn/api/jd-address` |
| 请求方法 | `POST` |
| 分类 | geo |
| 提供方 | 极数本源 |
| 计费模式 | 免费试用 |
| 单次消耗 | 0 积分 |
| 起步价 | — |
| QPS 限制 | 5 req/s |
| 每日免费额度 | 100 次（已认证用户） |
| 匿名每日额度 | 0 次（无 API Key） |
| VIP 免费 | 否 |
| 调用总次数 | undefined |

## 2. 认证

需要登录 API Key（避免被滥用刷京东接口）。

获取 API Key：登录 `https://apizero.cn/account/keys` 申请。

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `address` | `string` | 是 | 地址文本（≤200 字符） | `北京市朝阳区三里屯街道工体北路 8 号` |

## 4. 请求头

| Header | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `Authorization` | `string` | 是 | — | — |
| `Content-Type` | `string` | 是 | — | — |

## 5. 请求示例 (cURL)

```bash
curl -X POST "https://v1.apizero.cn/api/jd-address" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "address": "北京市朝阳区三里屯街道工体北路 8 号"
}'
```

## 6. 响应字段

| 字段 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- |
| `province_id` | `number` | 省 ID（京东体系） | — |
| `province` | `string` | 省名 | — |
| `city_id` | `number` | 市 ID | — |
| `city` | `string` | 市名 | — |
| `county_id` | `number` | 区 ID | — |
| `county` | `string` | 区名 | — |
| `town_id` | `number` | 镇 ID | — |
| `town` | `string` | 镇名 | — |
| `detail` | `string` | 剩余详细地址 | — |

## 7. 响应示例

```json
{
    "code": 0,
    "msg": "成功",
    "data": {
        "province_id": 1,
        "province": "北京",
        "city_id": 72,
        "city": "北京市",
        "county_id": 2818,
        "county": "朝阳区",
        "town_id": 53124,
        "town": "三里屯街道",
        "detail": "工体北路 8 号"
    }
}
```

## 8. 错误码

| code | status | 说明 |
| --- | --- | --- |
| `4000` | `—` | address 为空或超长 |
| `4000` | `—` | 地址解析失败（地址过于模糊或不规范） |
| `5020` | `—` | 京东接口失败 |

## 9. 变更日志

- **1.0.0** (2026-05-07)
  - 首次上线 · 4 级行政区划解析

---

**极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/jd-address`

Source: `https://apizero.cn/aidocs/jd-address/raw.md`
Last updated: 2026-05-11T16:16:07+08:00