快递查询
全国快递物流状态查询按次计费正常服务
接入点列表:
根据快递单号查询物流动态信息
post方式请求时,enctype应为application/x-www-form-urlencoded
上传文件二进制数据流方式,enctype必须为multipart/form-data
参数url、base64中有特殊字符时,建议对值urlencode编码后传递
| 名称 | 类型 | 必须 | 示例值/默认值 | 说明 |
|---|---|---|---|---|
| key | string | 是 | 您自己的APIKEY(注册账号后获得) | API密钥 |
| number | string | 是 | 9896725849291 | 快递单号 |
| company | string | 否 | huitong | 物流公司编码:如百世汇通:huitong |
| senderphone | string | 否 | 1288 | 收寄人手机尾号:目前顺丰系和中通强制要求,其他建议传入 |
公共参数指所有接口都会返回的参数,应用参数每个接口都不同
| 名称 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| 公共参数 | |||
| code | int | 200 | 状态码 |
| msg | string | success | 错误信息 |
| result | object | {} | 返回结果集 |
| 应用参数 | |||
| status | int | 4 | 0无记录、1揽件、2在途中、3 派送中、4已签收、5用户拒签、6疑难件、7无效单、8超时单、9签收失败、10退回、11转投、12待签 |
| updatetime | string | 2019-11-11 16:53:45 | 更新时间 |
| kuaidiname | string | 中通快递 | 快递公司中文名 |
| enkuaidiname | string | pingyou | 快递公司英文名 |
| telephone | string | 95311 | 快递公司客服电话 |
| time | string | 2019-10-25 16:48:08 | 物流节点时间 |
| address | string | 嘉定安亭网点 | 物流节点地址 |
| content | string | 【上海市】已签收, 签收人凭取货码签收...... | 物流节点详情 |
本接口为按次计费类接口,如接口可用次数不足可点此充值天豆
| 充值金额 | 可用次数 | 参考单价 |
|---|---|---|
| 免费 | 20次 | ≈0元/次 |
| 10元(10W天豆) | 1000次 | ≈0.01元/次 |
| 100元(110W天豆) | 11000次 | ≈0.0091元/次 |
| 500元(600W天豆) | 60000次 | ≈0.0083元/次 |
| 2000元(2600W天豆) | 260000次 | ≈0.0077元/次 |
| 2000元以上 | 套餐定制 | 联系商务客服 |
错误信息可能会有所调整,请根据错误状态码(code)进行流程判断
| 错误状态码 | 错误信息 | 解释帮助 |
|---|---|---|
| 100 | 内部服务器错误 | 报此错误码请及时反馈或等待官方修复 |
| 110 | 当前API已下线 | 接口已下线无法使用,可关注相关通知 |
| 120 | API暂时维护中 | 接口暂时关闭维护中,请注意相关公告 |
| 130 | API调用频率超限 | 超过每秒请求数上限,可在控制台-接口管理中查询 |
| 140 | API没有调用权限 | 请检查是否自行在接口管理中停用或被禁用了该接口 |
| 150 | API可用次数不足 | 免费类接口套餐超限或计次类接口余额不足,点此查看说明 |
| 160 | 账号未申请该API | 请先在接口文档页面申请该接口,点此查看说明 |
| 170 | Referer请求来源受限 | 设置了Referer白名单,但来源Referer不在白名单内 |
| 180 | IP请求来源受限 | 设置了IP白名单,但来源IP不在白名单内 |
| 190 | 当前key不可用 | 通常为账号无效,此状态无法恢复 |
| 230 | key错误或为空 | 请检查apikey是否填写错误,点此查看帮助 |
| 240 | 缺少key参数 | 请检查是否传递了key参数或者编码格式是否符合要求 |
| 250 | 数据返回为空 | 数据查询或转换失败,请检查输入值或注意中文编码问题 |
| 260 | 参数值不得为空 | 请检查关键参数是否传递了空值 |
| 270 | 参数值不符合要求 | 参数值不符合基本格式要求,点此查看说明 |
| 280 | 缺少必要的参数 | 缺少必填的参数,请根据接口文档检查 |
| 290 | 超过最大输入限制 | 参数值超过输入范围,请查看接口文档的说明 |
| 错误码1开头的是系统级错误,2开头的是用户级错误,其中200表示请求成功处理并计费。 | ||