快递智能地址解析API接口对接实现指南

快递智能地址解析API接口对接实现指南

随着电商和物流行业的快速发展，地址解析已成为提高效率和优化用户体验的重要技术手段。本文将详细介绍快递100智能地址解析API的功能、应用效果以及对接实现过程，帮助开发者快速上手。

---

一、智能地址解析接口介绍

快递100智能地址解析接口，是一款基于文本或图片数据的高效地址解析服务。
它可以精准识别输入内容中的 姓名、电话、地址 等关键信息，并将杂乱无序的地址数据纠错、补全和标准化，输出为结构化的地址信息：

格式
省 - 市 - 区 - 详细地址
例如
浙江省 杭州市 滨江区 长河街道春波南苑一幢*单元***号

功能亮点

1. 文本与图片解析：支持文本与图片两种输入形式，方便灵活。
2. 地址自动补全：对缺失字段（如省市区）进行智能补全，确保地址完整性。
3. 纠错与优化：自动纠正常见错别字或错误地址描述。
4. 高效对接：简单易用的接口，适配多种开发环境。

---

二、应用场景与效果

通过快递100智能地址解析API，用户能够在地址录入场景中更加高效地填写订单信息，尤其适用于个人地址薄管理和寄件操作。以下是具体应用效果：

结构化输出

输入任意格式的地址信息后，API将其按 省-市-区-详细地址 的标准格式输出，减少手动录入带来的失误，显著提升录入效率。

关键信息提取

能够精准提取寄件人或收件人信息中的 联系方式和姓名，并自动生成结构化数据，免去人工整理的麻烦，进一步降低错误率。

地址补全

结合 地图POI数据，在用户地址填写中自动补全缺失的地理位置信息，如门牌号或具体地点。用户可通过搜索地址坐标快速生成完整的地址，提升填写效率。

错误纠正与优化

针对用户输入的错误地址（如省、市、区字段），API提供智能纠正功能，确保下单信息完整、准确，有效避免因地址不全或错误导致的揽派问题。
这项技术为用户提供了高效、便捷的地址管理能力，同时帮助企业优化物流流程，提高订单的处理质量。

三、接口测试与对接指南

在对接快递100智能地址解析API前，我们需要完成以下步骤：

1. 注册与获取API Key

• 前往 快递100开发者中心 注册账号。
• 在接口管理中申请智能地址解析API，获取 API Key 和 Secret。
  可以参考我之前的这篇文章《快递100 物流查询API全面解析》

2. 智能地址解析接口

该接口提供智能识别姓名、电话、地址的功能，并解析地址返回对应信息。

1.1 接口格式

提供统一格式的 HTTP POST 调用接口，并返回统一格式的 JSON 数据。

1.2 请求地址

https://api.kuaidi100.com/address/resolution

请求参数（header）：

参数名	类型	默认值
Content-Type	string	application/x-www-form-urlencoded

请求参数（body）：

参数名	是否必填	类型	说明
key	是	string	授权码，请申请企业版获取
sign	是	string	32 位大写签名，用于验证身份，按 MD5(param + t + key + secret) 的顺序加密，不需要加上 “+” 号，secret 在企业管理后台查看
t	是	string	时间戳，如：1576123932000
param	是	param	由其他字段拼接

param 数据结构：

参数名	是否必填	类型	说明
content	否	string	需要解析的内容，例如：张三广东省深圳市南山区粤海街道科技南十二路金蝶软件园13088888888
image	否	string	图片 base64 编码，最大限制 4M
imageUrl	否	string	图片 URL，通过该 URL 下载后得到的文件文件类型应当是图片，最大限制 4M
pdfUrl	否	string	PDF URL，通过该 URL 下载后得到的文件文件类型应当是 PDF，最大限制 4M
htmlUrl	否	string	HTML URL，通过该 URL 下载后得到的文件文件类型应当是 HTML，最大限制 4M

注意： 接口超时为 5 秒。content、image、imageUrl、pdfUrl、htmlUrl 必填其一，优先顺序为：content > image > imageUrl > pdfUrl > htmlUrl。

1.3 返回结果

字段	类型	说明	备注
success	boolean	提交结果	true 提交成功，false 失败
code	string	返回编码
message	string	返回报文描述
time	string	时间	可忽略
data	Object	响应数据

data 数据结构：

字段	类型	说明	备注
taskId	string	任务 ID
result	list	解析结果列表

result 中数据项的数据结构：

字段	类型	说明	备注
content	string	入参的解析内容
mobile	list	手机号码列表	列表中的手机号码为字符串格式
name	string	姓名
address	string	详细地址
xzq	object	行政区信息

xzq 中数据项的数据结构：

字段	类型	说明	备注
fullName	string	完整地址	返回省市区全称，例如：广东省,深圳市,南山区
province	string	省份名称	返回省份简称，例如：广东
city	string	城市名称	返回市级行政区简称，例如：深圳市
district	string	区县名称	返回区县简称，例如：南山区
subArea	string	详细地址
parentCode	string	行政区父节点编码
code	string	行政区编码
level	int	行政区级别

1.4 请求参数示例

示例1

key = kytRstexx
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1470304729724
param = {
   
    "content": "张三广东省深圳市南山区粤海街道科技南十二路金蝶软件园13088888888"
}

示例2

key = kytRstexx
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1470304729724
param = {
   
    "imageUrl": "https://api.kuaidi100.com/getImage/123456789"<