收货地址识别

识别国内常见快递收货地址文本，支持姓名/电话/地区乱序、换行、逗号、带字段标签、常用省市区简称及手机号分段输入。使用本地行政区划快照匹配；缺项、同名地区及不确定内容会提示人工核对，不调用外部 AI，个人地址不存日志或缓存。

接口地址

请求方式POST / JSON

身份认证Bearer API Key

所属分类数据查询

调用费用免费

包月要求不强制包月

调用限制不限

补充说明

POST /api/v1/endpoints/address-parse；Bearer API Key；JSON参数 text（最大2000字符）；返回 recipient/mobile/province/city/district及code、detail、confidence、needs_confirmation、warnings。支持乱序、换行、常见标注及简称；同名地区与缺项须由用户确认；不支持港澳台/海外。

请求参数

除 Bearer API Key 请求头外，使用 application/json 发送以下字段。图片接口的文件需先转成纯 Base64 字符串提交。

字段名称	格式	说明
`text`	字符串	必填，最多 2000 字符；姓名、电话、地址顺序不限

非预期参数将被忽略；非法参数 HTTP 422。接口执行异常统一返回失败响应，不计为成功扣点。请仅提交您有权处理的文本、图片或网页内容。

示例代码

将密钥和业务字段替换为自己的实际值，不要在公开网页或 App 内写入管理员密钥。

cURL

curl -X POST "https://api.dcykjgw.com/api/v1/endpoints/address-parse" \
  -H "Authorization: Bearer dcy_你的完整密钥" \
  -H "Content-Type: application/json" \
  -d '{"text":"张三 13800123456 广东省深圳市南山区科苑路15号A栋601"}'

JavaScript

fetch('https://api.dcykjgw.com/api/v1/endpoints/address-parse', {
  method: 'POST',
  headers: {'Content-Type':'application/json','Authorization':'Bearer dcy_你的完整密钥'},
  body: JSON.stringify({"text":"张三 13800123456 广东省深圳市南山区科苑路15号A栋601"})
}).then(r => r.json()).then(console.log);

响应结构

{
  "code": 0,
  "msg": "处理成功",
  "platform": "address-parse",
  "data": {
    "recipient": "张三",
    "mobile": "13800123456",
    "province": "广东省", "province_code": "44",
    "city": "深圳市", "city_code": "4403",
    "district": "南山区", "district_code": "440305",
    "detail": "科苑路15号A栋601",
    "confidence": 100,
    "needs_confirmation": false,
    "warnings": [],
    "source": "local-rules"
  }
}

识别结果仅供地址表单预填，实际下单前应由用户确认。省市区采用本地快照，置信度是启发式完整性评分，不代表统计学概率。港澳台和国外地址暂不支持；手机号、地址原文均不写日志或服务端缓存。

返回参数说明

字段	格式	说明
`code`	数字	业务状态码，0 表示本次接口调用成功；非 0 时结合 msg 和 HTTP 状态码排查。
`msg`	字符串	本次请求结果说明，成功时描述处理结果，失败时给出可读错误原因。
`platform`	字符串	当前接口/平台标识，成功响应中用于区分具体接口来源。
`data`	对象	接口业务数据；具体字段含义见下方本接口字段说明。
`data.recipient`	字符串	识别出的收件人姓名。
`data.mobile`	字符串	识别出的手机号码。
`data.province / city / district`	字符串	识别出的省、市、区县名称。
`data.province_code / city_code / district_code`	字符串	对应行政区划代码。
`data.detail`	字符串	详细地址。
`data.confidence`	数字	本地规则完整性评分，不是统计学概率。
`data.needs_confirmation`	布尔值	是否建议人工确认。
`data.warnings`	字符串数组	需要人工核对的提示。
`data.source`	字符串	识别来源，当前为本地规则。

无效参数 HTTP 422；无效密钥 401；权限限制 403；点数不足 402；频率超限 429；服务暂不可用 503。

在线测试 · 收货地址识别

请填写自己的 API Key。图片只上传到当前 API 请求，不保存到浏览器本地存储；图片 Base64 在下方结果中自动隐藏。

响应结果

填写参数后点击“发送测试请求”。