This is an auto-generated translation

租车预订检索 API

有关访问租车预订检索 API 的指南和示例

通过租车预订检索 API,您可以检索 Expedia 预订的详细信息(无论预订是通过预订 API 还是在 Expedia 网站上完成的)。

端点

方法端点前提条件*
GEThttps://apim.expedia.com/cars/bookings/[行程编号]来自租车预订 API 的有效行程编号。

必需的标头

Key:Expedia API 密钥
Authorization:Expedia API 授权字符串
Accept:application/vnd.exp-car.v3+json
User-Id:username@domain.com

与预订相关联的邮箱地址。

Partner-Transaction-Id:合作伙伴交易 ID 字符串

后续步骤

  • 通过租车取消 API 取消租车预订。

租车预订检索请求示例

请求

https://apim.expedia.com/cars/bookings/71184721958

预订检索响应示例

{
    "TransactionId": "f06edfa3-27f4-44e6-838c-b8dd3d0a3210",
    "ItineraryNumber": 7152088262,
    "SupplierConfirmationNumber": "abcdjjggdd",
    "Status": "Cancelled",
    "BookingDateTime": "2016-11-21T02:05:00+0000",
    "LastUpdateDateTime": "2016-11-21T03:05:00+00:00",
        "BillingDetails": {
        "CreditCard": {
            "CardNumber": "XXXXXXXXXXXX4448",
            "CardType": "Visa"
        }
    },
    "TokenizedPaymentDetails": {
        "FpanPaymentInstrumentId": "5D4F566D-9C6D-701B-E2B6-DC0D22D985EC"
    },
    "TripStartDateTime": "2021-13-02T15:40:00-08:00",
    "TripEndDateTime": "2021-23-02T15:40:00-08:00",
    "CarDetails": {
        "VehicleDetails": {
            "Make": "Kia Rio",
            "CarClass": "Economy 2/4Door Car",
            "MinDoors": 4,
            "MaxDoors": 4,
            "FuelLevel": "Full to Full",
            "CarCategory": {
                "Code": "M",
                "Value": "Mini"
            },
            "CarType": {
                "Code": "M",
                "Value": "2/4 Door"
            },
            "TransmissionDrive": {
                "Code": "M",
                "Value": "Manual AWD"
            },
            "FuelAC": {
                "Code": "D",
                "Value": "Diesel Air"
            },
            "Capacity": {
                "AdultCount": 4,
                "ChildCount": 0,
                "SmallLuggageCount": 2,
                "LargeLuggageCount": 1
            }
        },
        "Supplier": {
            "Id": "6",
            "Name": "Alamo Rent A Car",
            "Code": "AL"
        },
        "PickupDetails": {
            "DateTime": "2021-07-05T10:00:00",
            "ShuttleCategory": "AirportShuttleToCounterAndCar",
            "Location": {
                "Code": "SEA",
                "LocationId": "SEAT001",
                "Address": {
                    "Address1": "99 Union St",
                    "Address2": "123",
                    "City": "Seattle",
                    "Province": "WA",
                    "Country": "USA"
                },
                "GeoLocation": {
                    "Latitude": "47.60772",
                    "Longitude": "-122.33936"
                }
            }
        },
        "DropOffDetails": {
            "DateTime": "2021-07-05T10:00:00",
            "ShuttleCategory": "AirportShuttleToCounterAndCar",
            "Location": {
                "Code": "SEA",
                "LocationId": "SEAT001",
                "Address": {
                    "Address1": "99 Union St",
                    "Address2": "123",
                    "City": "Seattle",
                    "Province": "WA",
                    "Country": "USA"
                },
                "GeoLocation": {
                    "Latitude": "47.60772",
                    "Longitude": "-122.33936"
                }
            }
        },
        "RateDetails": {
            "RatePeriod": "Daily",
            "RateCode": "A3D10",
            "Prepay": false,
            "CreditCardRequired": false,
            "Discounts": [
                {
                    "Type": "CouponCode",
                    "Code": "G811490"
                },
                {
                    "Type": "CorpDiscountCode",
                    "Code": "C811490"
                }
            ],
            "Mileages": [
                {
                    "FreeDistance": {
                        "Value": "12",
                        "Unit": "KM"
                    },
                    "FreeDistanceRatePeriod": "Daily",
                    "ExtraCostPerDistance": {
                        "Distance": {
                            "Value": "1",
                            "Unit": "KM"
                        },
                        "Cost": {
                            "Value": "12.36",
                            "Currency": "USD"
                        }
                    }
                },
                {
                    "FreeDistance": {
                        "Value": "12",
                        "Unit": "KM"
                    },
                    "FreeDistanceRatePeriod": "ExtraHour",
                    "ExtraCostPerDistance": {
                        "Distance": {
                            "Value": "1",
                            "Unit": "KM"
                        },
                        "Cost": {
                            "Value": "12.36",
                            "Currency": "USD"
                        }
                    }
                }
            ]
        },
        "Price": {
            "RatePeriodUnitPrice": {
                "Value": "99.00",
                "Currency": "USD",
                "LocalCurrencyPrice": {
                    "Value": "83.73",
                    "Currency": "EUR"
                }
            },
            "BasePrice": {
                "Value": "198.00",
                "Currency": "USD",
                "LocalCurrencyPrice": {
                    "Value": "167.45",
                    "Currency": "EUR"
                }
            },
            "TaxesAndFees": {
                "Value": "10.00",
                "Currency": "USD",
                "LocalCurrencyPrice": {
                    "Value": "8.46",
                    "Currency": "EUR"
                }
            },
             "TotalPriceDueAtBooking": {
                "Value": "406.48",
                "Currency": "USD",
                "LocalCurrencyPrice": {
                    "Value": "343.77",
                    "Currency": "EUR"
                }
            },
            "TotalPrice": {
                "Value": "406.48",
                "Currency": "USD",
                "LocalCurrencyPrice": {
                    "Value": "343.77",
                    "Currency": "EUR"
                }
            }
        },
        "TaxesAndFeesDetails": [
            {
                "Description": "Percent, PREMIUM LOCATION FEE",
                "Amount": {
                    "Value": "10.00",
                    "Currency": "USD",
                    "LocalCurrencyPrice": {
                        "Value": "8.46",
                        "Currency": "EUR"
                    }
                }
            },
            {
                "Description": "Percent, VALUE ADDED TAX",
                "Amount": {
                    "Value": "12.21",
                    "Currency": "USD",
                    "LocalCurrencyPrice": {
                        "Value": "10.33",
                        "Currency": "EUR"
                    }
                }
            }

        ],
        "ExtraFeesDetails": [
        {
            "Unit": "ExtraDaily",
            "UnitCount": 1,
            "Amount": {
                "Value": "23.57",
                "Currency": "USD",
                "LocalCurrencyPrice": {
                    "Value": "17.85",
                    "Currency": "GBP"
                }
            }
        }],
        "AdditionalFees": [
            {
                "IsRequired": true,
                "FinanceCategory": "Fee",
                "FinanceSubCategory": "Drop",
                "Amount": {
                    "Value": "325.07",
                    "Currency": "USD",
                    "LocalCurrencyPrice": {
                        "Value": "274.92",
                        "Currency": "EUR"
                    }
                },
                "Description": "DropOffCharge"
            }
        ],
        "SpecialEquipments": [
          {
                "Code": "AdditionalDriver",
                "Name": "Additional driver",
                "RatePeriod": "Daily",
                "BookingStatus": "Unconfirmed",
                "Price": {
                    "Value": "12.58",
                    "Currency": "USD"
                }
            }
       ],
        "RentalLimits": {
            "MinDuration": {
                "Unit": "Day",
                "Count": 1
            },
            "MaxDuration": {
                "Unit": "Day",
                "Count": 1
            }
        },
        "CancellationPolicy": {
            "Cancellable": true,
            "FreeCancellation": true,
            "FreeCancellationEndDateTime": "2020-12-27T10:00:00"
        },
        "CarPolicies": [
            {
                "CategoryCode": "Guarantee",
                "PolicyText": "Credit card required."
            },
            {
                "CategoryCode": "CreditCard",
                "PolicyText": "Credit cards acceptable for deposit, ax ba ca dc ds mc vi. credit cards acceptable for guarantee ax ba ca dc ds mc vi "
            }
        ],
        "Images": [
            {
                "Type": "Thumbnail",
                "Size": "t",
                 "Href": "https://images.trvl-media.com/cars/41/ZI_USA_Ford_Edge_SF_20160706_t.jpg"
             },
             {
                "Type": "Image",
                "Size": "s",
                  "Href": "https://images.trvl-media.com/cars/41/ZI_USA_Ford_Edge_SF_20160706_s.jpg"
              }
        ]
    },
    "Travelers": [{
        "Primary": true,
        "Name": {
            "FirstName": "John",
            "LastName": "Doe",
            "MiddleName": "Edward"
        },
        "Phone": {
            "CountryCode": 1,
            "AreaCode": 206,
            "Number": 9876543
        },
        "Email": "john.doe@gmail.com"
    }],
    "Links": {
        "WebItinRetrieve": {
            "Href": "https://www.expedia.com/1234567"
        },
        "ApiCancel": {
            "Accept": "application/vnd.exp-booking.v3+json",
            "Method": "PUT",
            "Href": "https://apim.expedia.com/cars/bookings/12345"
        }
    },
    "PartnerMetaData": {
        "MetaDataKey": "MetaDataValue"
    }
}

错误代码

常见错误代码

HTTP 状态代码错误代码错误消息
400UNKNOWN_PATH未知的请求路径。
400INVALID_ACCEPT Accept 缺失或无效。请提供正确的 Accept 标头,如下所示:Accept:application/vnd.exp-<product>.<version>+<format> (product={car,flight,hotel},version={v3},format={json})。
400只允许一个 Accept 标头。
400INVALID_PARTNER_TRANSACTION_ID Partner-Transaction-Id 缺失。
400只允许一个 Partner-Transaction-Id 标头。
400INVALID_CLIENT_KEY 无效的客户端密钥:XXX。
400只允许一个 Key 标头。
400INVALID_USER_ID Http 标头中的 User-Id 缺失或无效。必须是有效邮箱地址。
400只允许一个 User-Id 标头。
400INVALID_USER_CREDENTIALS用户凭据缺失或无效。
400ITINERARY_NOT_FOUND未找到行程。请提供有效的用户 ID 和行程编号。
400RETRIEVE_ITINERARY_ERROR无法检索行程编号 XXX 的数据。请稍后再试。
400INVALID_CURRENCY货币缺失或无效。
500RETRIEVE_APPLICATION_ERROR检索失败。应用程序错误。

警告代码

常见警告代码

代码消息说明
UNSUPPORTED_PRODUCT_TYPE此预订包含不受支持的产品类型:xxx。我们的 API 仅处理租车类型的产品。请单独处理 xxx。当预订不受支持的产品时,系统会返回此警告。

API 详情

在这里,您可以查看此 API 的端点定义,然后转到 API Explorer 以试用所有 XAP 端点、下载 OpenAPI 规范或下载 Postman 集合。您可以使用其中一个或所有选项进行测试,从而了解示例和模式定义与实际输出的比较。


您觉得这个页面有用吗?
我们该如何改进这些内容?
感谢您帮助我们改进!