2.3.3 订单查询
约 391 字大约 1 分钟
2025-04-24
提示
- 必须.
- 以下场景会触发订单详情查询
- 下单接口超时
- 下单接口返回
bookPending状态,klook会在接下来的30分钟内查询30次订单详情,以便获取最新的订单状态`
- 需要支持仅klook订单号查询订单的能力,因为存在下单接口超时情况下无供应商订单号
- 订单查询status永远返回订单最新的状态.比如先下单后取消,查询订单状态会返回
cancelSuccess状态
URL
接入方自行定义并提供给klook
入参
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
klookOrderCode | String | true | klook 订单号 |
supplierOrderCode | String | false | 供应商订单号，下单接口超时情况下查询订单详情无供应商订单号 |
入参示例
示例
{
"base": {
"requestAgent": "KLOOK",
"openApiSign": "301e4cfefbc376c4f4c4dac8b096efcdee47810c2a3627b29b2d3a66b8ae04af27f4ff38c4a8d40dff48f6729fe0d7959fdd90f1848f25c595b574872b8ec69a",
"requestId": "xxxxx111bbbbbcccc",
"requestTime": "2025-11-28T12:06:15.890+08:00"
},
"requestData": {
"klookOrderCode": "",
"supplierOrderCode": ""
}
}Curl示例说明
curl --location 'https://api.klookxxxxxxx.com.tw/xxxx/klook/queryOrder' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic T3BlbkFwaUtsb29rOxxxkQxxxxxx==' \
--data '{
"base": {
"openApiSign": "ed55b368d26a9c2be0f7bcfda2e174e31e7d31f59a48685ef4c6097eb7277a792d01d7766f8a7ecbddd63bd05bf61292b19297caa30280bc900a66259829f17a",
"requestAgent": "KLOOK",
"requestId": "BB1CEDE37C214219BE7C32468173D4B1",
"requestTime": "2025-06-18T11:59:59.045Z"
},
"requestData": {
"klookOrderCode": "GFE439622",
"supplierOrderCode": "m2025061sdsdlOSEasP"
}
}'出参
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
supplierOrderCode | String | true | 供应商订单号 |
supplierConfirmCode | String | false | 供应商确认号 |
hotelConfirmCode | String | false | 酒店确认号，如果有多个逗号分割 |
status | String | true | 订单状态 见3.1字典订单状态 orderStatus中的下单和取消，比如 bookPending,cancelSuccess |
出参示例
{
"success": true, // 当false时。error需要返回错误信息
"error": {
"code": "",
"message": ""
},
"result": {
"supplierOrderCode": "",
"supplierConfirmCode": "",
"hotelConfirmCode": "",
"status": ""
}
}