Register air cargo trackings
# Endpoint
POST https://api.track123.com/gateway/open-api/tk/v1/aviation/track/import
# Interface description
Up to 100 tracking numbers can be imported at a time, the interface frequency limit is 3 requests/sec. The results include both accepted and rejected lists. The accepted list is consist of successful registered trackings and the rejected list is consist of failed ones.
- Note: Importing an air waybill number will consume 200 tracking quotas.
# Request parameter
Name | Description | Required | Data type |
---|---|---|---|
trackingNo | Tracking number | true | String |
carrierCode | The unique carrier code | false | String |
# Request example
[
{
"carrierCode": "atlasair",
"trackingNo": "369-84941043"
},
{
"carrierCode": "atlasair",
"trackingNo": "369-987654321"
}
]
# Response parameter
Name | Description | Type |
---|---|---|
code | Service status code | string |
msg | The description information corresponding to the service status code or other auxiliary description information. | string |
data | Object actually returned | object |
accepted | Successful registration of tracking number | array[object] |
trackingNo | Tracking number | String |
carrierCode | The unique carrier code | String |
rejected | Rejected registration of tracking number | array[object] |
trackingNo | Tracking number | String |
carrierCode | The unique carrier code | Integer |
error | Error | object |
code | Error code | String |
msg | Error infomation | String |
# Response example
{
"code": "00000",
"data": {
"accepted": [
{
"trackingNo": "369-987654321",
"carrierCode": "atlasair"
}
],
"rejected": [
{
"trackingNo": "369-84941043",
"carrierCode": "atlasair",
"error": {
"msg": "单号已经注册,请检查",
"code": "A0400"
}
}
]
},
"msg": "成功",
"traceId": "6058fd26a116449899a3b98c6a52547a.147.16709341862880651"
}