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

快递查询

全国快递物流状态接口会员接口正常调用
  • 接口价格:100天行币(0.01元/次)
  • 永久额度:300次,注册后一次赠送的额度
  • 每天赠送:高级会员100次,黄金会员500次
    全国快递物流状态查询,默认支持自动根据单号查询快递物流动态,请注意:顺丰快递需同时传递寄件方或收件方手机号后四位。部分快递需同时传递快递名称的拼音才可以查询物流数据,如百世快递(汇通)的中文拼音是huitong。
    ▼ 接入信息
  • 接口地址:http://api.tianapi.com/txapi/kuaidi/index
  • 请求示例:http://api.tianapi.com/txapi/kuaidi/index?key=APIKEY&number=9896725849291
  • 支持协议:HTTP/HTTPS
  • 请求方式:GET/POST
  • 返回格式:UTF8 JSON
▼ 请求参数
请求参数类型必填参数位置示例值备注说明
keystringurlParam用户自己的APIKEYapi密钥
numberstringurlParam9896725849291快递单号
companystringurlParamhuitong快递中文拼音,如百世快递(汇通):huitong
senderphonestringurlParam13800138000寄件方手机号码后四位
receiverphonestringurlParam13900139000收件方手机号码后四位
▼ 返回示例
▼ 返回参数
返回参数类型示例值备注说明
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【上海市】已签收, 签收人凭取货码签收......物流节点详情
▼ 接口价格
用户等级永久赠送额度每日赠送额度综合免费调用次数备注说明
普通用户0天行币0永久0次新用户注册即可获得永久赠送额度在线充值
高级会员30000天行币10000天行币永久300次+每日100次开通会员即享永久赠送额度+每日赠送额度
黄金会员30000天行币50000天行币永久300次+每日500次开通会员即享永久赠送额度+每日赠送额度
提示:普通用户可以调用免费接口并消耗永久额度。会员用户优先使用每日赠送额度。如需要更高额度或不限次调用,请联系我们调整等级和给予最大优惠。
▼ 错误状态码
错误代码错误消息解释帮助
100内部服务器错误出现此错误码请及时反馈或等待修复
110接口暂时维护中接口暂时关闭维护中,请注意相关公告
120IP请求来源受限设置了IP白名单
130API调用频率超限API超出了分钟频率限制
140API没有调用权限该API只有会员或特定用户才可以调用
150天行币余额不足账号天行币余额不足,请在个人中心查看
160账号未申请该接口请先在对应的接口详情页面申请接口
230key错误或为空请检查apikey是否填写错误或未正确传递
240缺少key参数请检查是否传递了key参数,如变量请检查是否赋值
250数据查询失败数据查询或转换失败
260关键词不得为空word参数不要传递null或空值
270缺少有效数据部分接口需要传递数据,请按接口说明来
280缺少必要的参数缺少必填的参数,请根据接口文档检查
290超过资源字节限制超过了最大输入字节限制
1开头的是系统级错误,2开头的是用户级错误,其中200代码表示数据请求成功。
▼ 参考代码

其他可直接使用的部分开源项目推荐。另外此处的参考代码都是get方式请求,post请求请参考此项目

留言反馈