当前位置: 首页 > api商店 > 快递查询Api接口详情
快递查询

已调用:44532万次

  • 首次赠送50次
  • {{ng_buyapi.formatMoney(500)}}次
  • {{ng_buyapi.formatMoney(1000)}}次
  • {{ng_buyapi.formatMoney(5000)}}次
  • {{ng_buyapi.formatMoney(10000)}}次
  • {{ng_buyapi.formatMoney(50000)}}次
  • {{ng_buyapi.formatMoney(100000)}}次

价格:{{ng_buyapi.buy_sale}}元 按次

立即添加 免费在线使用
接口简介:可查询快递物流信息近500+家全国快递,1个单号,自动识别,包括:顺丰、申通、圆通、韵达、中通、汇通、EMS、天天、国通、德邦、宅急送等几百家快递物流查询。
  • Api文档
  • 状态码说明
  • 请求示例

接口地址: https://api.storeapi.net/pyi/63/170(支持:http/https)

返回格式:json,xml

请求方式:POST,GET

Api测试工具

请求说明:

名称 必填 类型 示例 说明
appid String 1 应用ID,在后台我的应用查看或者添加
exp_no String 3703743553612 快递/物流单号
exp_type String zto 物流公司缩写:当值为空时,不选择快递公司
format String json 返回数据格式类型,每个接口已经说明支持返回格式:json,xml
sign String 52a32be274a5c537bbf7a53e2d66c09f 参数按一定规则md5后返回的字符串,详情点击这里阅读

加密顺序

sign = MD5( appid1exp_no3703743553612exp_typeztoformatjson密钥) 查看加密规则说明
红色部分代表参数值,appid默认为1,请修改为自己的appid值,去我的应用查看以及密钥
*注意:空值不参与加密。

返回参数说明:

名称 必填 类型 示例 说明
codeid Integer 10000 状态码,返回10000状态都会进行计费。具体说明可查看状态码说明
exp_courier String 快递员
exp_courierPhone String 13142921759 快递员电话
exp_deliverystatus String 3
exp_expName String 中通快递 快递公司名称
exp_expPhone String 95311 快递公司电话
exp_expSite String www.zto.com 快递公司官网
exp_issign String 1
exp_list Array 快递信息数据对象集合
exp_msg String ok 状态描述
exp_number String 73113465980453 快递单号
exp_result Array 返回的数据对象集合
exp_status String 0 快递查询错误码,详情点击这里查看
exp_type String zto 物流公司缩写:当值为空时,不选择快递公司
list_status String 【厦门市】 【厦门思明三部】(0592-5991759、0592-5991719) 的 李猛(13600947133) 已揽收 快递当前到达的网点
list_time String 2019-05-17 19:04:33 快递到达该网点的时间
message String 返回成功 请求状态说明
retdata Array 回数据集合,可能是数据、对象或者字符串
time String 1558418814 请求时传递的当前服务器时间戳

JSON返回示例:

服务器状态码:

状态码 说明
10017 time必须是整型
10004 时差不能超过10分钟,可以不传递这个参数,注意时间戳单位是秒
10005 appid错误,请检查appid值,前往会员中心->我的应用查看或添加
10012 没有订购任何api,请前往购买后再操作
10006 当前IP地址未授权,请前往用户中心->我的应用添加ip
10019 发生错误:{@info}
10003 sign值验证不通过,加密规则请前往帮助中心查看
10020 子接口不存在,可能已经被关闭
10021 服务器发生错误
10015 参数个数错误
10001 appid必须指定,可以我的应用里面查看
10008 应用内没有该接口,请到我的应用里面添加这个接口
10018 次数不足
10013 该接口已经暂停使用
10011 api已经到期
10010 您没有订购该api
10009 api接口不存在
10002 sign值必须指定,加密规则请前往帮助中心查看
10007 应用被禁用,请联系客服处理
10014 未知的错误,可以联系客服处理
10000 返回成功

请选择开发语言:

  • PHP
  • Python
$api_url = 'https://api.storeapi.net/pyi/63/170';
$appid  =   '应用id';// 在后台我的应用查看;
$secret =   '应用密钥';// 在后台我的应用查看;
$data = array(
                'appid'=>  '1',
                'exp_no'=>  '3703743553612',
                'exp_type'=>  'zto',
                'format'=>  'json',
            );
$data['appid'] = $appid;
$data['time'] = time();//当前服务器时间
ksort($data); //按照键名对数组排序,为数组值保留原来的键。
$md5String = '';
foreach($data as $key=>$val){
    if(strlen($val)>0){ //过滤空值
        $md5String.=$key.$val;
    }
}
$sign = md5($md5String.$secret);
$data['sign'] = $sign;
$sendUrl = $api_url.'?'.http_build_query($data); //把数据转换成url参数形式,a=b&c=d&e=f
$result = file_get_contents($sendUrl);
print_r($result);
                        
#!/usr/bin/python3
# -*- coding: UTF-8 -*-
#该代码为python3.7示例代码
import ssl,time,hashlib
from urllib import request,parse,error;

api_url = 'https://api.storeapi.net/pyi/63/170';
appid  =   '应用id';#在后台我的应用查看;
secret =   '应用密钥';#在后台我的应用查看;
data = {
                'appid':'1',
                'exp_no':'3703743553612',
                'exp_type':'zto',
                'format':'json',
            };
data['appid'] = appid;
data['time'] = round(time.time());#当前服务器时间
keysArr = list(data.keys()) #取出字典key
keysArr.sort()#对字典key进行排序
md5String = '';
params = []
for key in keysArr:
    if data[key]:
        val = str(data[key])
        md5String+=key+val
        params.append(key + "=" + val )
md5String += secret;
m = hashlib.md5()
b = md5String.encode(encoding='utf-8')
m.update(b)
sign = m.hexdigest()

params.append('sign='+sign)#加入计算后的sign值去请求
params = '&'.join(tuple(params)); #把列表转成元组后用&分隔,最终转换成字符串 a=b&c=d&e=f

ssl._create_default_https_context = ssl._create_unverified_context
req = request.Request(api_url+'?'+params)
opener = request.build_opener()
r = opener.open(fullurl=req)
doc = r.read();
print(doc.decode('utf-8'))