接口路径(新):http://api.okayapi.com/api/App/KdAPI/Track
接口路径(旧):http://api.okayapi.com/?s=App.KdAPI.Track
接口描述: 快递鸟API,物流查询API提供实时查询物流轨迹的服务,用户提供运单号和快递公司,即可查询当前时刻的最新物流轨迹。使用前请先配置快递鸟API。支持部分快递公司,可免费查询500次。
Parameter | Type | Required | Default | Note | Description |
---|---|---|---|---|---|
HTTP_APPKEY | String | Required | MIN: 32 | Common Put Your APPKEY | |
ShipperCode | String | Required | MIN: 1 | 快递公司编码,如:EMS物流单号应选择快递公司编码(EMS),查看快递公司编码。注意:主流快递仅支持申通快递、圆通速递、百世快递、天天快递 4 家,不支持 EMS、邮政 快递包裹、顺丰速运、韵达速递、京东快递、中通快递。 | |
LogisticCode | String | Required | MIN: 1 | 物流单号,按照运单号查询(单个查询) | |
OrderCode | String | Optaion | 订单编号 |
// 请求
{OKAYAPI_API_HOST}/?s=App.KdAPI.Track&return_data=0&ShipperCode=JD&LogisticCode=JD0027305472696
// 返回(有物流轨迹的)
{
"ret": 200,
"data": {
"err_code": 0,
"err_msg": "",
"KdAPI": {
{
"EBusinessID": "1109259",
"OrderCode": "",
"ShipperCode": "SF",
"LogisticCode": "118461988807",
"Success": true,
"State": 3,
"Reason": null,
"Traces": [
{
"AcceptTime": "2014/06/25 08:05:37",
"AcceptStation": "正在派件..(派件人:邓裕富,电话:18718866310)[深圳 市]",
"Remark": null
},
{
"AcceptTime": "2014/06/25 04:01:28",
"AcceptStation": "快件在 深圳集散中心 ,准备送往下一站 深圳 [深圳市]",
"Remark": null
}
]
}
}
}
,
"msg": "V3.3.0 YesApi App.KdAPI.Track"
}
// 返回 异常
{
"ret": 200,
"data": {
"err_code": 0,
"err_msg": "",
"KdAPI": {
"LogisticCode": "4308067010027",
"ShipperCode": "YD",
"Traces": [],
"State": "0",
"EBusinessID": "1684491",
"Reason": "业务错误[不支持当前快递公司的查询]",
"Success": false
}
},
"msg": "V3.3.0 YesApi App.KdAPI.Track"
}
KEY | Type | Description |
---|---|---|
err_code | Int | 操作码,0表示成功,正数表示业务失败场景,负数表示系统失败场景 |
err_msg | String | 错误提示信息,err_code非0时参考此提示信息 |
KdAPI | Object | 快递鸟API返回的结果 |
KdAPI.EBusinessID | String | 用户ID |
KdAPI.OrderCode | String | 订单编号 |
KdAPI.ShipperCode | String | 快递公司编码 |
KdAPI.LogisticCode | String | 物流运单号 |
KdAPI.Success | bool | 成功与否 |
KdAPI.Reason | String | 失败原因 |
KdAPI.State | String | 物流状态:2-在途中,3-签收,4-问题件 |
KdAPI.Traces | Array | 跟踪情况 |
KdAPI.Traces[].AcceptTime | String | 时间 |
KdAPI.Traces[].AcceptStation | String | 描述 |
KdAPI.Traces[].Remark | String | 备注 |
Parameter | Type | Required | Default | Note | Description |
---|---|---|---|---|---|
HTTP_APPKEY | String | Required | MIN: 32 | Common Put Your APPKEY | |
ShipperCode | String | Required | MIN: 1 | 快递公司编码,如:EMS物流单号应选择快递公司编码(EMS),查看快递公司编码。 | |
LogisticCode | String | Required | MIN: 1 | 物流单号,按照运单号查询(单个查询) | |
OrderCode | String | Optaion | 订单编号 | ||
CustomerName | String | Optaion | ShipperCode 为JD,必填,对应京东的青龙配送编码,也叫商家编码,格式:数字+字母+数字,9 位数字加一个字母,共10 位,举例:001K123450;ShipperCode 为SF,且快递单号非快递鸟渠道返回时,必填,对应收件人/寄件人手机号后四位;ShipperCode 为SF,且快递单号为快递鸟渠道返回时,不填;ShipperCode 为其他快递时,不填 |
// 请求
{OKAYAPI_API_HOST}/?s=App.KdAPI.Track&return_data=0&ShipperCode=JD&LogisticCode=JD0027305472696
// 返回(有物流轨迹的)
{
"ret": 200,
"data": {
"err_code": 0,
"err_msg": "",
"KdAPI": {
{
"EBusinessID": "1109259",
"OrderCode": "",
"ShipperCode": "SF",
"LogisticCode": "118461988807",
"Success": true,
"State": 3,
"Reason": null,
"Traces": [
{
"AcceptTime": "2014/06/25 08:05:37",
"AcceptStation": "正在派件..(派件人:邓裕富,电话:18718866310)[深圳 市]",
"Remark": null
},
{
"AcceptTime": "2014/06/25 04:01:28",
"AcceptStation": "快件在 深圳集散中心 ,准备送往下一站 深圳 [深圳市]",
"Remark": null
}
]
}
}
}
,
"msg": "V3.3.0 YesApi App.KdAPI.Track"
}
// 返回 异常
{
"ret": 200,
"data": {
"err_code": 0,
"err_msg": "",
"KdAPI": {
"LogisticCode": "4308067010027",
"ShipperCode": "YD",
"Traces": [],
"State": "0",
"EBusinessID": "1684491",
"Reason": "业务错误[不支持当前快递公司的查询]",
"Success": false
}
},
"msg": "V3.3.0 YesApi App.KdAPI.Track"
}
KEY | Type | Description |
---|---|---|
err_code | Int | 操作码,0表示成功,正数表示业务失败场景,负数表示系统失败场景 |
err_msg | String | 错误提示信息,err_code非0时参考此提示信息 |
KdAPI | Object | 快递鸟API返回的结果 |
KdAPI.EBusinessID | String | 用户ID |
KdAPI.OrderCode | String | 订单编号 |
KdAPI.ShipperCode | String | 快递公司编码 |
KdAPI.LogisticCode | String | 物流运单号 |
KdAPI.Success | bool | 成功与否 |
KdAPI.Reason | String | 失败原因 |
KdAPI.State | String | 物流状态:2-在途中,3-签收,4-问题件 |
KdAPI.Traces | Array | 跟踪情况 |
KdAPI.Traces[].AcceptTime | String | 时间 |
KdAPI.Traces[].AcceptStation | String | 描述 |
KdAPI.Traces[].Remark | String | 备注 |
Power by OkayAPI.com Contact us (WA: okayapi OR Email: chanzonghuang@gmail.com).
Timezone: America/New_York Apr/24/2024 20:30:37