全国快递物流状态接口
  • 152
  • 14051

快递查询

全国快递物流状态接口独立计费正常调用
  • 该接口申请即送20次免费调用额度
  • 接口价格:100天豆一次(≤0.01元)
    全国快递物流状态查询,默认支持自动根据单号查询快递物流动态,请注意:顺丰快递需同时传递寄件方或收件方手机号后四位。部分快递需同时传递快递名称的拼音才可以查询物流数据,如百世快递(汇通)的中文拼音是huitong。
    ▼ 接口信息
  • 接口地址:http://api.tianapi.com/kuaidi/index
  • 请求示例:http://api.tianapi.com/kuaidi/index?key=APIKEY&number=9896725849291
  • 支持协议:http/https
  • 请求方式:get/post
  • 返回格式:utf-8 json
▼ 请求参数

post方式请求时,enctype应为application/x-www-form-urlencoded

上传文件二进制数据流方式,enctype必须为multipart/form-data

参数url、base64中有特殊字符时,建议对值urlencode编码后传递

名称类型必填示例值/默认值说明
keystring您自己的APIKEY(注册账号后获得)api密钥
numberstring9896725849291快递单号
companystringhuitong快递中文拼音,如百世快递(汇通):huitong
senderphonestring13800138000寄件方手机号码后四位
receiverphonestring13900139000收件方手机号码后四位
▼ 返回示例

返回示例作为参考,建议以实际测试结果为准

▼ 返回参数
名称类型示例值说明
statusint4-1待查询、0查询异常、1暂无记录、2在途中、3 派送中、4已签收、5用户拒签、6疑难件、7无效单、8超时单、9签收失败、10退回
updatetimestring2019-11-11 16:53:45更新时间
kuaidinamestring中通快递快递公司中文名
telephonestring95311快递公司客服电话
timestring2019-10-25 16:48:08物流节点时间
contentstring【上海市】已签收, 签收人凭取货码签收......物流节点详情
▼ 接口价格
用户等级免费接口数每日赠送次数会员价格说明
提示:本接口为按次独立计费接口,调用价格为100天豆/次(0.01元),如接口可用次数不足请点此充值天豆(优惠)。
▼ 错误状态码

错误消息可能会有所调整,请根据错误代码进行流程判断

错误代码错误消息解释帮助
100内部服务器错误报此错误码请及时反馈或等待官方修复
110当前API已下线接口已下线无法使用,可关注相关通知
120API暂时维护中接口暂时关闭维护中,请注意相关公告
130API调用频率超限超过每秒请求数上限,可在控制台-接口管理中查询
140API没有调用权限请检查是否自行在接口管理中停用或被禁用了该接口
150API可用次数不足账号余额不足以调用接口,请在控制台中查看
160账号未申请该API请先在接口文档页面申请该接口,点此查看说明
170Referer请求来源受限设置了Referer白名单,但来源Referer不在白名单内
180IP请求来源受限设置了IP白名单,但来源IP不在白名单内
190当前key已限制使用通常为账号被限制使用,此状态无法恢复
230key错误或为空请检查apikey是否填写错误,点此查看帮助
240缺少key参数请检查是否传递了key参数或者编码格式是否符合要求
250数据返回为空数据查询或转换失败,请检查输入值或注意中文编码问题
260参数值不得为空请检查关键参数是否传递了空值
270参数值不符合要求参数值不符合基本格式要求,点此查看说明
280缺少必要的参数缺少必填的参数,请根据接口文档检查
290超过最大输入字节限制超出最大字符限制,请查看接口文档的说明
1开头的是系统级错误,2开头的是用户级错误,其中200代码表示请求成功处理并计费。
▼ 参考代码

其他可直接下载使用的部分开源项目推荐。

此处代码并非完整项目,仅供参考,实际使用请根据本地开发环境修改。

活动推荐EXERCISE 更多>

开通会员专享福利
联系客服 咨询反馈