中文地址解析

概述

一行 API 从中文地址字符串中提取「省市区街道 + 详细地址 + 姓名 + 手机号 + 邮编」。 适用场景：电商收货地址自动拆分、快递下单页智能填充、CRM 客户资料清洗、办公地址结构化入库。 特点：纯本地正则算法，无任何服务依赖，毫秒级响应；支持 34 个省级行政区及其简称识别（如「北京」→「北京市」、「新疆」→「新疆维吾尔自治区」）；支持快递场景下「张三 138xxxxxxxx 上海市浦东新区xx路xx号 200000」这类混合输入的自动拆分。

鉴权

未登录匿名 1 QPS · 50 次/日；已登录默认 20 QPS · 1000 次/日（按账号等级浮动）

获取 API Key：获取 API Key/account/keys

请求参数

POST · APPLICATION/JSON

{
  "address": "张三 13812345678 上海市浦东新区张江镇科苑路88号 201203"
}

返回结果

顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "original": "张三 138****1234 上海市浦东新区张江镇科苑路88号 201203",
    "province": "上海市",
    "city": "上海市",
    "district": "浦东新区",
    "street": "张江镇",
    "detail": "科苑路88号",
    "zipcode": "201203",
    "phone": "138****1234",
    "name": "张三"
  },
  "request_id": "kx8n9q2a1b3c4d5e6f7g",
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -X POST "https://v1.apizero.cn/api/address-parse" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "address": "张三 13812345678 上海市浦东新区张江镇科苑路88号 201203"
}'

错误码

先看业务 code。HTTP 也可能不是 200。

调用限制

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

• 1.0.02026-05-04

  首次发布：支持 34 个省级行政区（含简称）解析 支持嵌入式快递地址解析（姓名 / 手机号 / 邮编混合输入） 纯本地正则，毫秒级响应，无服务依赖