快递查询的 API 主要由以下几个部分组成:
1. 快递公司编码
2. 快递单号
3. 快递查询 API 接口地址
4. 快递查询 API 的请求方式:GET 或 POST
5. 快递查询 API 的返回数据格式:JSON 或 XML
以下以顺丰快递为例,介绍如何调用其快递查询 API。
1. 快递公司编码
每个快递公司都有唯一的公司编码,开发者需要在调用 API 时传入该快递公司编码以便 API 正确识别所查询的快递公司。
顺丰的快递公司编码为“SF”。
2. 快递单号
快递单号是需要查询的快递单号,开发者需要在调用 API 时传入该快递单号以便 API 查找该快递单号的物流信息。
3. 快递查询 API 接口地址
顺丰的快递查询 API 接口地址为:http://www.sf-express.com/sf-service-web/service/bills/{快递单号}/routes?app=bill&contentType=json&lang=sc_CN®ion=cn&translate=
其中,{快递单号} 为需要查询的快递单号。
4. 快递查询 API 的请求方式
顺丰快递查询 API 的请求方式为 GET。
5. 快递查询 API 的返回数据格式
顺丰快递查询 API 的返回数据格式为 JSON。
通过访问上述接口,开发者可以得到如下格式的 JSON 数据:
```
{
"mailNo": "SF101288888888",
"transType": "1",
"expressType": "1",
"expressTypeName": "顺丰速运",
"deliverType": "1",
"status": "1",
"statusCode": "200",
"billImage": "",
"remark": "",
"routes": [
{
"address": "",
"time": "2022-03-06 11:01:55",
"remark": "在顺丰科技园进行中转集包",
"opcode": "50"
},
...
]
}
```
其中,"mailNo" 字段为快递单号,"expressTypeName" 字段为快递公司名称,"status" 字段为快递单当前的状态,"routes" 字段为物流轨迹信息数组。
通过解析返回的 JSON 数据,开发者就可以根据自己的需求展示快递信息了。