快递查询API接口 - 天行数据TianAPI

全国快递物流状态接口

152
338

快递查询

全国快递物流状态接口会员接口正常调用

接口价格：100天行币（0.01元/次）
永久额度：300次，注册后一次赠送的额度
每天赠送：高级会员100次，黄金会员500次

在线测试申请接口

▼ 接口文档
价格
错误码
参考代码
生成小程序

▼ 接入信息

接口地址：http://api.tianapi.com/txapi/kuaidi/index
请求示例：http://api.tianapi.com/txapi/kuaidi/index?key=APIKEY&number=9896725849291
支持协议：HTTP/HTTPS
请求方式：GET/POST
返回格式：UTF8 JSON

▼ 请求参数

请求参数	类型	必填	参数位置	示例值	备注说明
key	string	是	urlParam	用户自己的APIKEY	api密钥
number	string	是	urlParam	9896725849291	快递单号
company	string	否	urlParam	huitong	快递中文拼音，如百世快递（汇通）：huitong
senderphone	string	否	urlParam	13800138000	寄件方手机号码后四位
receiverphone	string	否	urlParam	13900139000	收件方手机号码后四位

▼ 返回示例

▼ 返回参数

返回参数	类型	示例值	备注说明
status	int	4	-1待查询、0查询异常、1暂无记录、2在途中、3 派送中、4已签收、5用户拒签、6疑难件、7无效单、8超时单、9签收失败、10退回
updatetime	string	2019-11-11 16:53:45	更新时间
kuaidiname	string	中通快递	快递公司中文名
telephone	string	95311	快递公司客服电话
time	string	2019-10-25 16:48:08	物流节点时间
content	string	【上海市】已签收, 签收人凭取货码签收......	物流节点详情

▼ 接口价格

用户等级	永久赠送额度	每日赠送额度	综合免费调用次数	备注说明
普通用户	0天行币	0	永久0次	新用户注册即可获得永久赠送额度在线充值
高级会员	30000天行币	10000天行币	永久300次+每日100次	开通会员即享永久赠送额度+每日赠送额度
黄金会员	30000天行币	50000天行币	永久300次+每日500次	开通会员即享永久赠送额度+每日赠送额度
提示：普通用户可以调用免费接口并消耗永久额度。会员用户优先使用每日赠送额度。如需要更高额度或不限次调用，请联系我们调整等级和给予最大优惠。

▼ 错误状态码

错误代码	错误消息	解释帮助
100	内部服务器错误	出现此错误码请及时反馈或等待修复
110	接口暂时维护中	接口暂时关闭维护中，请注意相关公告
120	IP请求来源受限	设置了IP白名单
130	API调用频率超限	API超出了分钟频率限制
140	API没有调用权限	该API只有会员或特定用户才可以调用
150	天行币余额不足	账号天行币余额不足，请在个人中心查看
160	账号未申请该接口	请先在对应的接口详情页面申请接口
230	key错误或为空	请检查apikey是否填写错误或未正确传递
240	缺少key参数	请检查是否传递了key参数，如变量请检查是否赋值
250	数据查询失败	数据查询或转换失败
260	关键词不得为空	word参数不要传递null或空值
270	缺少有效数据	部分接口需要传递数据，请按接口说明来
280	缺少必要的参数	缺少必填的参数，请根据接口文档检查
290	超过资源字节限制	超过了最大输入字节限制
1开头的是系统级错误，2开头的是用户级错误，其中200代码表示数据请求成功。

▼ 参考代码

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

留言反馈返回顶部