快递单号订阅API接口_免费数据接口

1、单号订阅

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

返回格式：JSON

请求方式：POST

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

请求参数：

参数名称	类型	必填	说明
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	快递单号

JSON返回实例：

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

2、单号查询

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

返回格式：JSON

请求方式：POST

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

请求参数：

参数名称	类型	必填	说明
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	物流状态描述快递公司原样返回

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
	}
}

3、快递公司

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

返回格式：JSON

请求方式：GET

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

请求参数：

参数名称	类型	必填	说明

返回参数：

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

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"
        }
    ]
}

4、异步通知

接口地址：您设定的URL

返回格式：Array

请求方式：POST

请求示例：您设定的URL

请求参数：

参数名称	类型	必填	说明

返回参数：

参数名称	类型	说明
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	物流状态描述快递公司原样返回

代号	说明
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次	免费
Level1	10000次	600.00元
Level2	50000次	2600.00元
Level3	100000次	4700.00元
Level4	1000000次	31000.00元

快递单号订阅

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

API错误码

系统错误码