极速数据 - 领先的基础数据API接口提供商

首页生活常用快递单号订阅

快递单号订阅

快递单号订阅

134
150

支持韵达、圆通、申通、中通、百世、极兔等快递物流单号订阅、物流轨迹查询等功能，订阅后推送物流轨迹信息。查询物流信息子接口不计费，需要先订阅此单号。使用电子面单接口后，不用再次调用此接口订阅。

￥600.00/10000次

申请就送10次

接口已下架

接口地址： https://api.jisuapi.com/expresslogistics/subscribe

返回格式： JSON

请求方法： POST

请求示例： https://api.jisuapi.com/expresslogistics/subscribe?appkey=yourappkey

请求参数：

API在线测试

参数名称	类型	必填	说明
type	string	是	快递公司
senderprovince	string	是	寄件省份
sendercity	string	是	寄件城市
sendertown	string	是	寄件县/区
senderaddress	string	是	寄件人地址
sendername	string	是	寄件人姓名
sendermobile	string	是	寄件人手机号(手机号和电话二选一)
sendertel	string	是	寄件人电话(手机号和电话二选一)
sendercompany	string	否	寄件公司
senderzipcode	string	否	寄件邮编
addresseeprovince	string	是	收件省份
addresseecity	string	是	收件城市
addresseetown	string	是	收件县/区
addresseeaddress	string	是	收件人详细地址
addresseename	string	是	收件人姓名
addresseemobile	string	是	收件人手机号(手机号和电话二选一)
addresseetel	string	是	收件人电话(手机号和电话二选一)
addresseecompany	string	否	收件公司
addresseezipcode	string	否	收件邮编
sign	string	是	签名MD5加密规则参考代码

返回参数：

参数名称	类型	说明
orderno	string	订单号由我方生成
number	string	快递单号

请求代码：

PHP

<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey

$url = "https://api.jisuapi.com/expresslogistics/add?appkey=$appkey";
$appsecret = 'ssssssssssss';
$post = ['type'=>'', 'senderprovince'=>'', 'sendercity'=>'', 'sendertown'=>'', 'senderaddress'=>'', 'sendername'=>'', 'sendermobile'=>'', 'sendertel'=>'', 'sendercompany'=>'', 'senderzipcode'=>'', 'addresseeprovince'=>'', 'addresseecity'=>'', 'addresseetown'=>'', 'addresseeaddress'=>'', 'addresseename'=>'', 'addresseemobile'=>'', 'addresseetel'=>'', 'addresseecompany'=>'', 'addresseezipcode'=>'', 'product'=>'', 'ordertype'=>'', 'orderremark'=>'', 'accountid'=>'', 'password'=>'', 'weight'=>'', 'dimension'=>'', 'freighttype'=>'', 'producttype'=>'', 'freight'=>'', 'isnotice'=>'', 'starttime'=>'', 'endtime'=>'', 'collectionamount'=>'', 'insuredamount'=>''];//不包含appkey
$post['sign'] = makeSign($post, $appsecret);
$result = curlOpen($url, ['ssl'=>true, 'post'=>$post]);

$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));

if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
echo $result['orderno'].' '.$result['number'];

JSON返回示例 :

{
	"status":0,
	"msg":"ok",
	"result":{
		"orderno":"2021123232321",
		"number":"1026504666094"
	}
}

接口地址： https://api.jisuapi.com/expresslogistics/query

返回格式： JSON

请求方法： POST

请求示例： https://api.jisuapi.com/expresslogistics/query?appkey=yourappkey

请求参数：

API在线测试

参数名称	类型	必填	说明
type	string	是	快递公司
number	string	是	快递单号
sign	string	是	签名MD5加密规则参考代码

返回参数：

参数名称	类型	说明
number	string	快递单号
type	string	快递公司
typename	string	快递公司名称
logo	string	LOGO
deliveryname	string	快递员姓名
deliverymobile	string	快递员电话
signname	string	签收人
list	string	物流轨迹列表
time	string	时间
status	int	物流状态
city	string	城市
branch	string	网点
nextcity	string	下一站城市
nextbranch	string	下一站名称
description	string	物流节点描述
logisticsstatus	int	物流状态 1运输中 2派件中 3已签收 4签收失败 5收件扫描 6揽件扫描 7入中转 8出中转 9第三方代收入库 10第三方代收快递员取出 11退回件 12问题件 13拒收 14其他 15海外件入库扫描 16海外件出库扫描 17清关开始 18清关结束 19清关失败 20海外件干线到达 21海外件干线离开 22转单 23揽收失败 24已打包
statusdesc	string	物流状态描述快递公司原样返回

请求代码：

PHP

<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey

$url = "https://api.jisuapi.com/expresslogistics/update?appkey=$appkey";
$appsecret = 'ssssssssssss';
$post = ['type'=>'', 'senderprovince'=>'', 'sendercity'=>'', 'sendertown'=>'', 'senderaddress'=>'', 'sendername'=>'', 'sendermobile'=>'', 'sendertel'=>'', 'sendercompany'=>'', 'senderzipcode'=>'', 'addresseeprovince'=>'', 'addresseecity'=>'', 'addresseetown'=>'', 'addresseeaddress'=>'', 'addresseename'=>'', 'addresseemobile'=>'', 'addresseetel'=>'', 'addresseecompany'=>'', 'addresseezipcode'=>'', 'product'=>'', 'ordertype'=>'', 'orderremark'=>'', 'accountid'=>'', 'password'=>'', 'weight'=>'', 'dimension'=>'', 'freighttype'=>'', 'producttype'=>'', 'freight'=>'', 'isnotice'=>'', 'starttime'=>'', 'endtime'=>'', 'collectionamount'=>'', 'insuredamount'=>''];//不包含appkey
$post['sign'] = makeSign($post, $appsecret);
$result = curlOpen($url, ['ssl'=>true, 'post'=>$post]);

$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));

if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
echo $result['number'].' '.$result['type'].' '.$result['typename'].' '.$result['logo'].' '.$result['deliveryname'].' '.$result['deliverymobile'].' '.$result['signname'];
foreach($result['list'] as $key=>$val)
{
    echo $val['time'].' '.$val['status'].' '.$val['city'].' '.$val['branch'].' '.$val['nextcity'].' '.$val['nextbranch'].' '.$val['description'];
}

JSON返回示例 :

{
	"status":0,
	"msg":"ok",
	"result":{
		"number":"4303200322000",
		"type":"yunda",
		"typename":"韵达快运",
		"logo":"https://api.jisuapi.com/express/static/images/logo/80/yunda.png",
		"deliveryname":"",
		"deliverymobile":"",
		"signname":"",
		"list":[
			{
				"time":"2019-12-30 20:24:51",
				"status":3,
				"city":"北京",
				"branch":"北京分拨中心",
				"nextcity":"大连",
				"nextbranch":"大连分拨中心",
				"description":"北京分拨中心进行装车扫描，发往：辽宁大连分拨中心"
			}
		],
		"logisticsstatus":3
	}
}

接口地址： https://api.jisuapi.com/expresslogistics/type

返回格式： JSON

请求方法： GET

请求示例： https://api.jisuapi.com/expresslogistics/type?appkey=yourappkey

请求参数：

API在线测试

参数名称	类型	必填	说明

返回参数：

参数名称	类型	说明
name	string	快递公司名称
type	string	快递公司
letter	string	首字母
tel	string	电话
number	string	快递单号

请求代码：

PHP

<?php

require 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$url = "https://api.jisuapi.com/expresslogistics/type?appkey=$appkey";
$result = curlOpen($url, ['ssl'=>true]);

$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));
if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
foreach($jsonarr['result'] as $val)
{
    echo $val['name'].' '.$val['type'].'
';
}

JSON返回示例 :

{
    "status": 0,
    "msg": "ok",
    "result": [        
        {
            name: "中通",
			type: "ZTO",
			letter: "Z",
			tel: "95311",
			number: "421447644512",
			logo: "https://api.jisuapi.com/express/static/images/logo/80/zto.png"
        },
        {
            name: "圆通",
			type: "YTO",
			letter: "Y",
			tel: "021-69777888 021-69777999",
			number: "100668657244",
			logo: "https://api.jisuapi.com/express/static/images/logo/80/yto.png"
        },
        {
            name: "韵达",
			type: "YUNDA",
			letter: "Y",
			tel: "95546",
			number: "1202237859178",
			logo: "https://api.jisuapi.com/express/static/images/logo/80/yunda.png"
        },
        {
            name: "申通",
			type: "STO",
			letter: "S",
			tel: "95543",
			number: "403234843091",
			logo: "https://api.jisuapi.com/express/static/images/logo/80/sto.png"
        },
        {
            name: "百世快递",
			type: "HTKY",
			letter: "H",
			tel: "4009565656",
			number: "350630538314",
			logo: "https://api.jisuapi.com/express/static/images/logo/80/htky.png"
        },
        {
            name: "顺丰",
			type: "SFEXPRESS",
			letter: "S",
			tel: "95338",
			number: "952727764582",
			logo: "https://api.jisuapi.com/express/static/images/logo/80/sfexpress.png"
        }
    ]
}

接口地址：您设定的URL

返回格式： Array

请求方法： POST

请求示例：您设定的URL

接口说明：通知成功以后，需要输出“success”字符串

请求参数：

API在线测试

参数名称	类型	必填	说明

返回参数：

参数名称	类型	说明
type	string	快递公司
orderno	string	订单号
number	string	快递单号
time	string	时间
status	int	物流状态
city	string	城市
branch	string	网点
nextcity	string	下一站城市
nextbranch	string	下一站名称
description	string	物流节点描述
deliverymobile	string	快递员电话
logisticsstatus	string	物流状态
list	string	轨迹列表
statusdesc	string	物流状态描述快递公司原样返回

请求代码：

PHP

<?php

$post = $_POST;
$sign = $_POST['sign'];
unset($post['sign']);

$appsecret = '123456789';//用户appsecret
if(checkSign($post, $appsecret, $sign))
{
    $type = trim($_POST['type']);
    $orderno = trim($_POST['orderno']);
    $number = trim($_POST['number']);
	$logisticsstatus = trim($_POST['logisticsstatus']);
    $deliverymobile = trim($_POST['deliverymobile']);
	$list = json_decode(trim($_POST['list']), true);
    foreach($list as $val)
    {
        $time = trim($val['time']);    
        $city = trim($val['city']);
        $branch = trim($val['branch']);
        $nextcity = trim($val['nextcity']);
        $nextbranch = trim($val['nextbranch']);
        $description = trim($val['description']);
    }
    
    echo 'success';
    exit();
}

JSON返回示例 :

API错误码：

代号	说明
201	快递公司为空
202	不支持的快递公司
203	快递单号为空
204	快递单号错误
205	寄件人姓名不能为空
206	收件人姓名不能为空
207	寄件人省市都不能为空
208	单号没有信息
209	收件人省市都不能为空
210	寄件人地址不能为空
211	收件人地址不能为空
212	寄件人手机号和电话不能都为空
213	收件人手机号和电话不能都为空
216	签名为空
217	验签失败
230	未知错误

系统错误码：

代号	说明
101	APPKEY为空或不存在
102	APPKEY已过期
103	APPKEY无请求此数据权限
104	请求超过次数限制
105	IP被禁止
106	IP请求超过限制
107	接口维护中
108	接口已停用

计次套餐	套餐规格	价格
免费套餐	10次	0.00 元	≈0元/次
Level1	10000次	600.00 元	≈0.06元/次
Level2	50000次	2600.00 元	≈0.052元/次
Level3	100000次	4700.00 元	≈0.047元/次
Level4	1000000次	31000.00 元	≈0.031元/次

相关数据RELATED DATA 更多

活动推荐ACTIVITY 更多

相关资讯NEWS 更多

其它推荐RECOMMENDED DATA 更多

×

注册即可享受海量免费API接口服务立即注册登录

首页

关于

联系我们

0571-56565366

邮箱：kf@jisuapi.com

微信公众号

: 极速数据

微信群

: 极速数据④群

© 2015-2021 杭州极速互联科技有限公司版权所有浙ICP备17047587号-4 浙公网安备33010502005096 增值电信业务经营许可证：浙B2-20190875