快递智能识别单号技术文档
一、智能识别接口说明
1.1 请求地址
http://www.kuaidi100.com/autonumber/auto?num=[单号]&key=[key]
1.2 请求参数
请求参数（header）
| 名称 | 类型 | 默认值 |
|---|
| Content-Type | string | application/x-www-form-urlencoded |
请求参数（body）
| 参数名称 | 数据类型 | 是否必填 | 示例值 | 参数描述 |
|---|
| num | String | 必须 | 906919164534 | 快递单号 |
| key | String | 必须 | | 授权码，请申请企业版获取 |
1.3 返回结果
| 字段名称 | 字段描述 |
|---|
| lengthPre | 单号的长度 |
| comCode | 快递公司对应的编码 |
| name | 快递公司名称 |
1.4 正确返回示例
[{
"lengthPre": 15,
"comCode": "yuantong",
"name": "圆通速递"
}]
1.5 错误返回示例
{
"returnCode": "701",
"message": "key缺失",
"result": false
}
1.6 错误返回代码含义
| 返回代码 | 信息内容描述 | 原因及建议处理方式 |
|---|
| 601 | POLL: KEY 已过期 | 未开通智能单号识别接口。正式充值查询与订阅的套餐后，即可开通接口，免费使用智能单号识别的服务 |
| 701 | POLL: KEY 缺失 | 请求参数缺少key，请求时需要带上key |
