注册空运运单
# 接口地址
POST https://api.track123.com/gateway/open-api/tk/v1/aviation/track/import
# 接口描述
一次最多导入100个单号,接口请求限制频率为3 requests/sec。返回的结果包含accepted和rejected两个列表,accepted列表是导入成功的运单,rejected列表是导入失败的运单。单号和物流商都已经存在的重复运单,不会重复导入。但系统里已经存在这些运单,视为导入成功。
- 注意:导入一个空运单号,会消耗200个物流单号额度。
# 请求参数
参数名称 | 参数说明 | 必须 | 数据类型 |
---|---|---|---|
trackingNo | 单号 | true | String |
carrierCode | 承运人的简码 | false | String |
# 请求示例
[
{
"carrierCode": "atlasair",
"trackingNo": "369-84941043"
},
{
"carrierCode": "atlasair",
"trackingNo": "369-987654321"
}
]
# 响应参数
参数名称 | 参数说明 | 类型 |
---|---|---|
code | 业务状态码 | string |
msg | 业务状态码对应的描述信息或者其他辅助的描述信息 | string |
data | 返回体 | object |
accepted | 注册成功的单号 | array[object] |
trackingNo | 单号 | String |
carrierCode | 承运人对应的唯一简码 | String |
rejected | 注册失败的单号 | array[object] |
trackingNo | 单号 | String |
carrierCode | 承运人简码 | String |
error | 错误 | object |
code | 错误码 | String |
msg | 业务状态码对应的描述信息或者其他辅助的描述信息 | string |
# 响应示例
{
"code": "00000",
"data": {
"accepted": [
{
"trackingNo": "369-987654321",
"carrierCode": "atlasair"
}
],
"rejected": [
{
"trackingNo": "369-84941043",
"carrierCode": "atlasair",
"error": {
"msg": "单号已经注册,请检查",
"code": "A0400"
}
}
]
},
"msg": "成功",
"traceId": "6058fd26a116449899a3b98c6a52547a.147.16709341862880651"
}