入门指南
第一步是收集生成最终附件链接 URL 所需的所有信息。
以下是您需要提供的详细信息：
| 要求 | 来源 | 说明 |
|---|---|---|
partnerid | 由 Expedia Group 分享。 | 请求参数中使用的字符串值。例如：partnerid = partnername_hotel_conf_overlay |
| 秘密/私钥 | 由 Expedia Group 分享。 | 用于为每个签名生成一个 36 个字符的字母数字字符串partnerid。例如：第 1 页： partnerId = partnername_hotel_conf_overlaysecret key = 6f437404-261d-4beb-a7fc-43b92f694831第 2 页： partnerId = partnername_hotel_itin_overlaysecret key = 89f37407-821r-3des-a7f5-ghb92f694294 |
| 跟踪代码 | 由 Expedia Group 分享。 | 用于追踪合作伙伴网站广告位收入归因的代码。 |
| 深度链接 URL | 由 Expedia Group 分享。 | 例子： https://partnersitedomain/xsell-redirect-pwa?url=https%3A%2F%2Fpartnersitedomain%2Fgo%2Fhotel%2Fsearch%2FDestination%2F2026-08-25%2F2026-08-27%3FTrackingCodeHOTEL%26CityName%3DLAS%26SortBy%3DRECOMMENDED%26NumRoom%3D1%26NumAdult1%3D2&outboundEndDateTime=2026-08-25T16%3A53%3A00.000000Z&destinationTla=LAS&returnStartDateTime=2026-08-27T16%3A53%3A00.000000Z&originTla=SEA&bookingDateTime=2026-08-11T16%3A53%3A00.000000Z&attachDL=true&partnerId&signature |
| 端点 | xsell-redirect-pwa | 连接所需的端点。它是 case-sensitive。 |
| HMAC-SHA1 算法库 | 选择其中之一 >> Apache Commons Crypto 或者 | |
| >> Javax 加密 | 用于生成签名。 | |
| URL 编码 UTF-8 | >> UTF-8 百分比编码 | 用于对请求 URL 进行编码，以确保安全传输 |
电子邮件附件链接 URL 请求参数
| 参数 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
partnerid | 字符串 | Y | 由 Expedia Group 提供。 | partnername-POS-Ext-Flight-Conf-EmailDL |
url | 字符串 | Y | 按照深度链接指南，使用合作伙伴域名、搜索参数和跟踪代码创建酒店结果页面的深度链接请求 URL。请确保已包含跟踪代码mdpcid，并且输出参数的值正确为 URL-encoded。>> 阅读深度链接指南 | url = https%3A%2F%2Fexpedia.com%2Fgo%2Fhotel%2Fsearch%2FDestination%2F2025-12-22%2F2025-12-25%3Fmdpcid%3DMDPCID=Expedia-IE.DPS.en_IE.confemail.attachDL.Flightl%26CityName%3DORD%26SortBy%3Ddistance%26NumRoom%3D1%26NumAdult1%3D3%26NumChild1%3D2%26Rm1child1age%3D9%26Rm1child2age%3D6n |
outboundEndDateTime | 符合 ISO 8601 标准的日期字符串表示形式。 | Y | 请注明行程抵达目的地的日期和时间。根据 ISO 8601 标准，它应该只包含日期、时间和时区。 该参数值需要进行编码。 | 2025-10-30T20%3A12%3A17.928020Z |
originTLA | 字符串（3 个字母） | Y | 指定行程出发地的 IATA 机场代码。 | LAS |
returnStartDateTime | 符合 ISO 8601 标准的日期字符串表示形式。 | 仅往返需要 | 请指定从目的地返回的日期和时间。根据 ISO 8601 标准，它可以只包含日期、时间和时区。 该参数值需要进行编码。 | 2025-11-10T20%3A12%3A17.928020Z |
destinationTLA | 字符串（3 个字母） | Y | 指定行程目的地的 IATA 机场代码。 | JFK |
bookingDateTime | 符合 ISO 8601 标准的日期字符串表示形式。 | Y | 请注明预订日期和时间。根据 ISO 8601 标准，它可以只包含日期、时间和时区。 该参数值需要进行编码。 | 2025-07-25T20%3A12%3A17.928020Z |
bookingStatus | 字符串 | 如未提供相关信息，我们将默认预订已确认。 | 此参数的有效值为： • confirmed• pending• failed折扣价仅在确认后适用。 bookingStatus | confirmed |
attachDL | 布尔值 | Y | 将值设置为true以启用折扣附加费率。 | true |
signature | 字符串 | Y | 由合作伙伴根据 Expedia Group 提供的密钥生成 server-side。这个字符串的长度正好是 27 个字符。对生成的二进制签名进行编码。 | BcND1F7KElTyGtyUHeXHd2JJLFs |
注意： 请求参数区分大小写。大小写错误会导致程序出错。