空运查询接口说明
本文档将帮助您快速了解和使用产品功能。目前版本为1.x版本，后续会根据需要对API版本进行持续更新迭代。
快速入门
使用说明
海运 API 接口
快递 API 接口
空运 API 接口
WEBHOOK 推送
其它
空运查询 API 接口
空运实时查询
POST
/air-argo/realtime
realtime 实时查询接口，实时获取空运数据
一、发起请求:
- 请求允许以HTTP或HTTPS协议进行发送。
- 1. 完整链接
- HTTPS： https://api.toolstip.cn/v1/air-argo/realtime
- HTTP： http://api.toolstip.cn/v1/air-argo/realtime
- 2. 请求头
- 所有请求的头部都必须包含名为 Toolstip-Api-Key 的键，其对应值是你的 API Key。
- 表头中 Content-Type 对应值必须为 application/json，Content-Type 默认提供 UTF-8 格式的字符集参数，其他编码格式都不支持。
-
Content-Type: application/json Toolstip-Api-Key: YOUR_API_KEY
- 3. 请求参数
-
字段 描述 number 必须，空运单号，示例：06541952584
二、请求示例
-
curl -X POST -k "https://api.toolstip.cn/v1/air-argo/realtime" -H "Content-Type:application/json" -H "Toolstip-Api-Key:YOUR_API_KEY" -d '{"number":"06541952584"}'
三、响应示例
- 请求允许以HTTP或HTTPS协议进行发送。
- 1. 响应字段说明
-
字段 描述 origin 空运发件地/发件国家 destination 空运目的地/目的国家 air_code 空运三字简码 number 空运单号，示例：06541952584 status 空运状态，示例：货物签收 status_number 空运状态数值，示例：4（代表签收） - 2. 200响应示例
-
{ "meta": { "code": "065", "type": "Success", "message": "获取数据成功" }, "data": { "air_code": "SVA", "status": "货物签收", "number": "06541952584", "origin": "SZX", "destination": "CMN", "weight": "250.0", "unit": "kg", "piece": "3", "size": "", "status_number": 4, "is_pay": 0, "route": [{ "flight_number": "SV993", "depart_station": "SZX", "arrival_station": "RUH", "plan_depart_time": "2025-05-17 00:00:00", "depart_time": "2025-05-16 06:53:00", "plan_arrival_time": "2025-05-17 00:00:00", "arrival_time": "2025-05-17 07:56:00", "piece": "3", "weight": "250.0", "status": "RCF" }, { "flight_number": "SV1053", "depart_station": "RUH", "arrival_station": "JED", "plan_depart_time": "2025-05-18 00:00:00", "depart_time": "2025-05-19 00:18:00", "plan_arrival_time": "2025-05-18 00:00:00", "arrival_time": "2025-05-19 00:35:00", "piece": "3", "weight": "250.0", "status": "RCF" }, { "flight_number": "SV379", "depart_station": "JED", "arrival_station": "CMN", "plan_depart_time": "2025-05-20 00:00:00", "depart_time": "2025-05-20 13:56:00", "plan_arrival_time": "2025-05-20 00:00:00", "arrival_time": "2025-05-20 16:21:00", "piece": "3", "weight": "250.0", "status": "DLV" }], "detail": { "weight": "250.0", "piece": "3", "size": "", "info": [{ "plan_date": "2025-05-27 15:45:00", "actual_date": "2025-05-27 15:45:00", "event": "Delivered", "station": "CMN", "flight_number": "", "status": "DLV", "piece": "3", "weight": "250.0" }, { "plan_date": "2025-05-12 09:41:00", "actual_date": "2025-05-12 09:41:00", "event": "Booked", "station": "RUH", "flight_number": "SV993", "status": "BKD", "piece": "3", "weight": "255.0" }, { "plan_date": "2025-05-12 09:41:00", "actual_date": "2025-05-12 09:41:00", "event": "Booked", "station": "CMN", "flight_number": "SV379", "status": "BKD", "piece": "3", "weight": "255.0" }] }, "name": "沙特阿拉伯航空公司", "name_en": "Saudia Cargo ", "update_at": "2026-04-25 16:20:54", "last_event": "2025-05-27 15:45:00,Delivered,CMN" }, "error": [] } - 3. 异常响应示例
-
{ "meta": { "code": 202, "type": "Success", "message": "暂无符合条件的数据" }, "data": [], "error": [] }
获取列表数据
GET
/air-argo/get
get 接口，根据空运单号或时间条件获取已经创建的空运记录的数据，最大返回2000条记录
一、发起请求:
- 请求允许以HTTP或HTTPS协议进行发送。
- 1. 完整链接
- HTTPS： https://api.toolstip.cn/v1/air-argo/get
- HTTP： http://api.toolstip.cn/v1/air-argo/get
- 2. 请求头
- 所有请求的头部都必须包含名为 Toolstip-Api-Key 的键，其对应值是你的 API Key。
- 表头中 Content-Type 对应值必须为 application/json，Content-Type 默认提供 UTF-8 格式的字符集参数，其他编码格式都不支持。
-
Content-Type: application/json Toolstip-Api-Key: YOUR_API_KEY
- 3. 请求参数
-
字段 描述 air_code 可选，空运三字简码，示例：SVAnumber 可选，空运单号，示例：06541952584start 可选，创建记录最小时间，日期格式，示例：2022-07-27 12:00，如果number为空，则默认为最近60天end 可选，创建记录最大时间，日期格式，示例：2022-08-28 12:00
二、请求示例
-
curl -X GET -k "https://api.toolstip.cn/v1/air-argo/get?number=06541952584" -H "Content-Type:application/json" -H "Toolstip-Api-Key:YOUR_API_KEY"
三、响应示例
- 1. 响应字段说明
-
字段 描述 origin 空运发件地/发件国家 destination 空运目的地/目的国家 air_code 空运三字简码 number 空运单号，示例：06541952584 status 空运状态，示例：货物签收 status_number 空运状态数值，示例：4（代表签收） - 2. 200响应示例
-
{ "meta": { "code": "065", "type": "Success", "message": "获取数据成功" }, "data": [{ "air_code": "SVA", "status": "货物签收", "number": "06541952584", "origin": "SZX", "destination": "CMN", "weight": "250.0", "unit": "kg", "piece": "3", "size": "", "status_number": 4, "is_pay": 0, "route": [{ "flight_number": "SV993", "depart_station": "SZX", "arrival_station": "RUH", "plan_depart_time": "2025-05-17 00:00:00", "depart_time": "2025-05-16 06:53:00", "plan_arrival_time": "2025-05-17 00:00:00", "arrival_time": "2025-05-17 07:56:00", "piece": "3", "weight": "250.0", "status": "RCF" }, { "flight_number": "SV1053", "depart_station": "RUH", "arrival_station": "JED", "plan_depart_time": "2025-05-18 00:00:00", "depart_time": "2025-05-19 00:18:00", "plan_arrival_time": "2025-05-18 00:00:00", "arrival_time": "2025-05-19 00:35:00", "piece": "3", "weight": "250.0", "status": "RCF" }, { "flight_number": "SV379", "depart_station": "JED", "arrival_station": "CMN", "plan_depart_time": "2025-05-20 00:00:00", "depart_time": "2025-05-20 13:56:00", "plan_arrival_time": "2025-05-20 00:00:00", "arrival_time": "2025-05-20 16:21:00", "piece": "3", "weight": "250.0", "status": "DLV" }], "detail": { "weight": "250.0", "piece": "3", "size": "", "info": [{ "plan_date": "2025-05-27 15:45:00", "actual_date": "2025-05-27 15:45:00", "event": "Delivered", "station": "CMN", "flight_number": "", "status": "DLV", "piece": "3", "weight": "250.0" }, { "plan_date": "2025-05-12 09:41:00", "actual_date": "2025-05-12 09:41:00", "event": "Booked", "station": "CMN", "flight_number": "SV379", "status": "BKD", "piece": "3", "weight": "255.0" }] }, "name": "沙特阿拉伯航空公司", "name_en": "Saudia Cargo ", "update_at": "2026-04-25 16:31:19", "last_event": "2025-05-27 15:45:00,Delivered,CMN" }], "error": [] } - 3. 异常响应示例
-
{ "meta": { "code": 202, "type": "Success", "message": "暂无符合条件的数据" }, "data": [], "error": [] }