快递跟踪订阅

POST

http://apis.my56home.com/api/v1/expressapi-booking

调用该接口前，需要先使用[获取Token API]获取token。token 有效期是2小时，超过了2小时得重新获取。

请求参数

Query 参数

companyid

string

企业代码

可选

示例值:

token

string

可选

登录id（请先通过获取token接口获取token）

示例值:

1382b465-f972-46da-a5b2-1d286fa84d96

Body 参数multipart/form-data

localkeyid

string

本地系统关键字

可选

示例值:

5859f9a7-d0e8-428f-99f3-6e947169a005

trackno

string

快递单号

必需

示例值:

YT8946689954911

slug

string

承运商代码

可选

示例值:

yto

sluggroup

string

承运商集团代码

可选

lang

string

动态描述语言

可选

示例值:

trackingaccount

string

承运商官网跟踪账号

可选

trackingkey

string

跟踪密钥

可选

trackingshipdate

string

货物发货日期

可选

smses

string

可选

接受sms的电话号码

orgcountrycd

string

始发地国家代码

可选

orgstate

string

始发地州/省

可选

orgpostcd

string

始发地邮政编号

可选

org

string

始发地地点全称

可选

dstcountrycd

string

目的地国家代码

可选

dststate

string

目的地州/省

可选

dstpostcd

string

目的地邮政编号

可选

dst

string

目的地地点全称

可选

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://apis.my56home.com/api/v1/expressapi-booking?companyid=0&token=1382b465-f972-46da-a5b2-1d286fa84d96' \
--form 'localkeyid="5859f9a7-d0e8-428f-99f3-6e947169a005"' \
--form 'trackno="YT8946689954911"' \
--form 'slug="yto"' \
--form 'sluggroup=""' \
--form 'lang="zh"' \
--form 'trackingaccount=""' \
--form 'trackingkey=""' \
--form 'trackingshipdate=""' \
--form 'smses=""' \
--form 'orgcountrycd=""' \
--form 'orgstate=""' \
--form 'orgpostcd=""' \
--form 'org=""' \
--form 'dstcountrycd=""' \
--form 'dststate=""' \
--form 'dstpostcd=""' \
--form 'dst=""'

返回响应

🟢200成功

application/json

Body

result

array[object (快递跟踪订阅接口返回说明) {2}]

必需

success

boolean

API调用是否成功

必需

true=订阅API成功执行

result

array [object {7}]

具体单号订阅结果集

必需

具体单号订阅结果集

示例

成功示例失败示例

{
    "localkeyid": "5859f9a7-d0e8-428f-99f3-6e947169a005",
    "keyid": "da804b8a-c238-4140-9c5d-035f82d62ce3",
    "trackno": "YT8946689954911",
    "slug": "yto",
    "sluggroup": null,
    "success": true,
    "message": ""
}

特殊承运人代码表

快递跟踪下载