入门指南
第一步是收集生成最终附件链接 URL 所需的所有信息。
以下是您需要提供的详细信息：
| 要求 | 来源 | 说明 |
|---|---|---|
| 合作伙伴标识符 | 由 Expedia Group 分享。 | 合作伙伴 ID 是请求参数中使用的字符串值。 例如： PartnerId =partnername_hotel_conf_overlay |
| 秘密/私钥 | 由 Expedia Group 分享。 | 密钥是由 Expedia Group 为每个合作伙伴 ID 安全共享的字母数字字符串，用于生成签名。此密钥长度为 36 个字符。例如： 第 1 页： • PartnerId = partnername_hotel_conf_overlay• 密钥 = 6f437404-261d-4beb-a7fc-43b92f694831第 2 页： • PartnerId = partnername_hotel_itin_overlay• 密钥 = 89f37407-821r-3des-a7f5-ghb92f694294 |
| 跟踪代码 | 由 Expedia Group 分享。 | 用于追踪合作伙伴网站广告位收入归因的追踪代码。 |
| 端点 | xsell-redirect-pwa | |
| HMAC-SHA1 算法库 | https://commons.apache.org/crypto/download_crypto.cgi | 使用 HMAC-SHA1 算法库生成签名。 https://download.java.net/java/early_access/panama/docs/api/java.base/javax/crypto/package-summary.html |
| URL 编码 UTF-8 | http://en.wikipedia.org/wiki/Percent-encoding | |
| 深度链接指南：构建酒店搜索结果页面的第一个 URL。 | 深层链接 | 本文详细介绍了如何创建标准深度链接。 注意： 目标位置必须与您的模板站点支持的语言环境一致。 |
电子邮件附件链接 URL 请求参数
注意： 请求参数区分大小写。大小写错误会导致程序出错。
| 参数 | 类型 | 必填/可选 | 说明 | 样本值 |
|---|---|---|---|---|
PartnerId | 字符串 | 必填 | 由 Expedia Group 提供。 | partnername-POS-Ext-Flight-Conf-EmailDL |
url | 字符串 | 必填 | 使用合作伙伴域名、搜索参数和跟踪代码，按照深度链接指南创建酒店结果页面的深度链接请求 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 标准的日期字符串表示形式。 | 必填 | 请注明行程抵达目的地的日期和时间。根据 ISO 8601 标准，它应该只包含日期、时间和时区。 该参数值需要进行编码。 | 2025-10-30T20%3A12%3A17.928020Z |
originTLA | 字符串（3 个字母） | 必填 | 指定行程出发地的 IATA 机场代码。 | LAS |
returnStartDateTime | 符合 ISO 8601 标准的日期字符串表示形式。 | 可选 - 仅往返行程需要 | 请指定从目的地返回的日期和时间。根据 ISO 8601 标准，它可以只包含日期、时间和时区。 该参数值需要进行编码。 | 2025-11-10T20%3A12%3A17.928020Z |
destinationTLA | 字符串（3 个字母） | 必填 | 指定行程目的地的 IATA 机场代码。 | JFK |
bookingDateTime | 符合 ISO 8601 标准的日期字符串表示形式。 | 必填 | 请注明预订日期和时间。根据 ISO 8601 标准，它可以只包含日期、时间和时区。 该参数值需要进行编码。 | 2025-07-25T20%3A12%3A17.928020Z |
bookingStatus | 字符串 | 可选 - 如果未提供，我们将默认预订已确认。 | 此参数的有效值为： • confirmed• pending• failed折扣价仅在确认 bookingStatus后适用。 | confirmed |
attachDL | 布尔型 | 必填 | 将值设置为true以启用折扣附加费率。 | true |
signature | 字符串 | 必填 | 由合作伙伴根据 Expedia Group 提供的密钥生成 server-side。这个字符串的长度正好是 27 个字符。对生成的二进制签名进行编码。 | BcND1F7KElTyGtyUHeXHd2JJLFs |