最小可运行示例：中文地址解析API请求与响应字段全解析
适用场景电商收货地址自动拆分、快递下单页智能填充、CRM客户资料清洗、办公地址结构化入库这些场景都面临一个共同痛点用户输入的地址往往是混合字符串如张三 13812345678 上海市浦东新区张江镇科苑路88号 201203。人工拆分效率低且容易出错而调用中文地址解析API只需一次请求就能得到省/市/区/街道/详细地址/姓名/手机号/邮编等结构化字段。接口能力边界纯本地正则算法无上游依赖单次请求毫秒级响应。支持34个省级行政区及其简称识别如「北京」→「北京市」、「新疆」→「新疆维吾尔自治区」。支持混合输入拆分姓名、手机号、邮编可出现在地址前后任意位置。请求地址长度限制≤500字符。QPS20/s未登录匿名调用有更严格限流建议携带API Key。请求参数与鉴权鉴权方式接口支持Bearer Token鉴权可选在请求头中添加Authorization: Bearer sk_live_xxx。推荐生产环境携带Token以获得稳定的限流配额。匿名调用也可使用但QPS可能较低。请求体字段字段名类型必填描述示例值addressstring是中文地址字符串≤500字符支持姓名/手机/邮编混合张三 13812345678 上海市浦东新区张江镇科苑路88号 201203请求体必须为JSON对象Content-Type设置为application/json。curl 最小可运行示例以下是一个完整的POST请求可以直接复制到终端执行替换$APIZERO_API_KEY为你的真实Key或不加 -H 行以匿名方式调用curl -sS \ -X POST \ -H Content-Type: application/json \ -H Authorization: Bearer YOUR_API_KEY \ -d {address: 李四 15987654321 广东省深圳市南山区科技园南区R2-B栋 518057} \ https://v1.apizero.cn/api/address-parse注意示例中的YOUR_API_KEY需要替换成你自己的Key。如果匿名调用删除-H Authorization: ...行即可。成功响应示例JSON已格式化{ code: 0, data: { city: 深圳市, detail: 科技园南区R2-B栋, district: 南山区, name: 李四, original: 李四 159****1234 广东省深圳市南山区科技园南区R2-B栋 518057, phone: 159****1234, province: 广东省, street: , zipcode: 518057 }, msg: 成功, request_id: a1b2c3d4e5f6g7h8i9j0 }Python 代码接入示例使用Python的requests库即可完成调用。以下是一个最小可运行脚本包含异常处理和字段打印import requests import json # API地址请替换成真实Key或删除headers行进行匿名调用 url https://v1.apizero.cn/api/address-parse headers { Content-Type: application/json, Authorization: Bearer YOUR_API_KEY # 可选不留则匿名 } payload { address: 王五 13600000000 北京市朝阳区望京soho T1-15层 100102 } try: resp requests.post(url, jsonpayload, headersheaders, timeout5) resp.raise_for_status() data resp.json() if data.get(code) 0: result data[data] print(解析结果) print(f省份{result.get(province)}) print(f城市{result.get(city)}) print(f区县{result.get(district)}) print(f街道{result.get(street)}) print(f详细地址{result.get(detail)}) print(f姓名{result.get(name)}) print(f手机号{result.get(phone)}) print(f邮编{result.get(zipcode)}) else: print(f请求失败code{data.get(code)}, msg{data.get(msg)}) except requests.exceptions.RequestException as e: print(f网络异常{e}) except json.JSONDecodeError: print(响应非JSON格式)运行输出解析结果 省份北京市 城市北京市 区县朝阳区 街道望京soho T1-15层 详细地址望京soho T1-15层 姓名王五 手机号136****0000 邮编100102返回值详细解读成功HTTP状态码为200响应体JSON结构固定字段类型说明codeint状态码0表示成功非0表示错误msgstring描述信息request_idstring请求唯一标识可用于排查问题dataobject解析结果对象包含以下字段data.provincestring省份名称带“省”字直辖市为“北京市”等data.citystring城市名称直辖市与省同data.districtstring区/县级名称data.streetstring街道/镇名称如果存在data.detailstring详细地址门牌号、楼栋等data.namestring提取的姓名如无则为空data.phonestring手机号中间四位掩码如136****0000data.zipcodestring邮政编码如无则为空data.originalstring原始地址字符串手机号被掩码处理注意事项手机号部分返回掩码格式数据库存储时需注意。如果地址中未包含姓名或邮编对应字段为空字符串。street字段可能为空当地址未明确街道时如直接写“上海市浦东新区科苑路88号”。常见错误与处理HTTP状态码codemsg解决建议4001001参数错误检查address字段是否存在且为字符串4011002鉴权失败仅在使用Token时确认Authorization头格式正确Key有效4291003请求超限降低请求频率或携带API Key提升配额5002001服务内部错误重试或查看request_id联系技术支持建议在代码中统一捕获HTTPError并解析响应体中的code与msg。工程化注意事项请求重试策略对于429/500错误采用指数退避重试如最多3次间隔1s、2s、4s。批量处理如果一次性需要处理大量地址如CSV导入建议控制并发数不超过QPS限流20/s并携带Token。数据脱敏返回的original字段中的手机号已被掩码处理但若仍需原始手机号可在请求前自行备份。地址格式预检建议在调用前做前端校验如去除多余空格、统一全半角等可以提高解析准确率。Test环境可在代码中切换请求的url为测试环境若有或使用匿名调用进行功能验证。参考文档中文地址解析API文档原始文档Markdown
)
