接口描述
此接口是服務云中轉服務平臺接收行李保障平臺推送的行李狀態變化,目前一件行李正常可以收到三次狀態的變更:
* 前段航班到達后地服人員行李卸機時掃碼到預約的行李免提訂單,行李平臺調用此接口推送行李狀態為轉運中
* 地報人員裝機掃碼到行李免提訂單,行李平臺調用此接口推送行李狀態為已裝機
* 行李保障中出現異常需要中終直掛時,行李平臺調用此接口推送行李狀態為已中斷
接口地址
https://ip/api/luggage/changeDetailsStatus
請求參數
| 字段 |類型 |描述|是否必須|備注|
| --- | --- |---|---|---|
|airportOwner|String|進港機場|是|機場三字碼,如西安:XIY
|orderId|String|訂單ID|是|訂單創建時的ID|
|luggageInNo|String|行李號進港|否|行李直掛的必輸,其它不用|
|luggageOutNo|String|行李號出港|否|
|luggageTagType|String|行李標記類型|否|1超大,2晚到,3活物,4破損,5易碎(多個用逗號隔開)|
|luggageStatus|int|行李狀態|否|行李直掛的必輸(進港:1行李卸機,3行李中斷,4行李分揀 5行李運輸,6行李提取,出港:7行李托運,8行李安檢,9行李分揀,10行李運輸, 2行李裝機)
|interruption|int|中斷原因|否|異常類型:1航班延誤2行李破損3旅客自提9其它|
|handingtime|Datetime|處理時間|是|狀態更新時間yyyy-MM-dd HH:mm:ss
|operator|String|處理人|是|狀態更新人|
|remark1|String|保留字段1|否|備用|
|remark2|String|保留字段2|否|備用|
|remark3|String|保留字段3|否|備用|
請求報文
數據類型Content-Type: Params
~~~
appCode=""timeStamp=""sign=""
~~~
數據類型Content-Type: application/json
```
{
"airportOwner":"string",
"interruption":"string",
"luggageInNo":"string",
"luggageOutNo":"string",
"luggageStatus":1,
"luggageTagType":"string",
"operator":"string",
"orderId":"string",
"remark1":"string",
"remark2":"string",
"remark3":"string"
}
```
響應參數
| 字段 | | 類型 |描述 |備注
| --- | --- | --- | --- |--- | --- |
| code | |String|返回狀態|0 - 失敗 1 - 成功|
| message| |String|錯誤說明|請求失敗或者發生錯誤的具體描述
| timeStamp| |datetime|請求時間戳|請求時帶的時間戳
| result| |Object||結果集|1:創建行程 2:退票3:改簽 4:旅客取消
| | orderId|String|訂單ID|
| | luggageNoString|String|行李號|
| | remark1|String|保留字段1|
| | remark2|String|保留字段2|
| | remark3|String|保留字段3|
響應格式
```
{
"success":true,
"message":"success",
"code":1,
"timestamp":1567663129728,
"result":{
????????"orderDetailsId":"0264ce4f4f6d44b0804a7fe8f276bcb4",
????????"luggageInNo":"3324036756",
????????"orderId":"85398a5cb8aa4f45b000bacafbdb4dfb",
????????"updateTime":"2019-09-05?13:58:49",
????????"dest":null,
????????"luggageNum":2,
????????"luggageImages":null,
????????"luggageOutNo":null,
????????"luggageWeight":20,
????????"createTime":"2019-09-05?11:12:12",
????????"luggageTagType":"big",
????????"remark1":null,
????????"luggageStatus":1,
????????"remark3":null,
????????"remark2":null
????}
}
```