常见错误响应
Rapid API 各业务线共享通用的错误代码、消息和响应格式
这些错误适用于 Rapid 的所有业务线，包括：
- Rapid Lodging API
- Rapid 租车 API
- 快速飞行 API
- Rapid 当地玩乐 API
各业务线之间的任何差异均已注明。
Rapid API 错误处理
我们建议您的错误处理逻辑应包含以下几点，以避免出现问题：
- 确保已建立错误处理逻辑来处理购物和预订 API 错误。
- 除非以下说明另有规定，否则请始终为每个预订请求使用唯一的
affiliate_reference_id。 - 定期审查和更新错误处理逻辑，特别是针对预订请求的错误处理逻辑。
- 所有 Rapid API 响应都有对应的响应代码。
>> 查看 HTTP 响应代码。
连接超时或通信超时
对于航班 API 预订请求，建议将 API 连接超时设置为 120 秒；对于住宿和其他 API，我们建议设置为 90 秒。但是，您可以决定对购物可用性调用使用较短的连接超时时间。
如果在 120 秒内没有收到响应，Rapid API 将发出 5xx 错误，因为 Rapid API 自身的连接超时设置为 120 秒。
在某些情况下，Rapid API 不支持 HTTP Expect: 100-Continue 流程。使用该进程尝试连接服务器时，您可能会遇到连接问题，尤其是在 cURL、C#/.NET 和其他一些默认遵循该进程的编程语言中。
>> 了解更多关于 HTTP Expect: 100-Continue 的信息
**注意：**HTTP 504 网关超时并不表示 Rapid 已超时。在这些情况下，要么是基础设施服务发生故障，要么是 Rapid 充当了另一个下游服务的网关，并为该服务设置了超时限制。下游超时将触发 504 错误。如果 504 错误发生在 Booking 调用上，请检查预订是否是使用行程检索（affiliate_reference_id+ 电子邮件）创建的，因为下游问题可能发生在创建预订之前（酒店通信、支付服务器）或之后（Expedia Group 财务管理）。另外，请检查网络连接是否稳定。Traceroute 命令可能有助于识别连接问题。
处理预订和检索 5xx 错误
预订错误（5xx 状态）或超时并不一定意味着预订本身无效。该错误可能是在预订创建后发生的。我们建议您发送一封包含affiliate_reference_id+ 电子邮件的行程检索请求，以查看预订状态。
在 90 秒内返回的任何错误并不代表预订的最终状态。通常情况下，大多数预订会在 13-30 秒内确认，但有些预订可能需要长达 5 分钟才能确认。
您可以实现逻辑，在 90 秒内检查预订状态 3 次。大多数回复会在前 30 秒内得到确认，您可以无需等待完整的 90 秒即可确认回复。如果仍未收到最终回复，您可以稍后 30 分钟内重试检索，然后再联系 Rapid API 呼叫中心代理寻求进一步支持。
使用 Retrieve API 调用 double-confirm 获取预订结果（HTTP 200 或 HTTP 404 响应）。
检索响应返回保留/继续信息
有时，在成功预订住宿后，“行程检索”响应会返回看起来像是针对保留/恢复预订的响应数据。因此，响应中不会包含预期的预订信息（房间、取消罚款等），而只会包含用于保留/恢复情况的令牌。
原因是该预订虽然有效，但仍处于待处理状态。该标记通常会在几分钟内最终清除，因此，应重复发出行程检索申请，直到完成预订。
响应示例：
{
"itinerary_id": "2667552437552",
"links": [
{
"rel": "retrieve",
"method": "GET",
"href": "/v3/itinerary/{itinerary_id}?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
},
{
"rel": "resume",
"method": "PUT",
"href": "/v3/itinerary/{itinerary_id}?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
},
{
"rel": "cancel",
"method": "DELETE",
"href": "/v3/itinerary/{itinerary_id}?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
}
]
}多级结构分解错误
当 single-level 错误无法解释所有必要细节时，API 响应可能会将错误分解为多个级别。逐层分析信息有助于澄清和排除错误。
响应示例：
{
"type": "invalid_input",
"message": "An invalid request was sent in, please check the nested errors for details.",
"errors": [
{
"type": "duplicate_itinerary",
"message": "An itinerary already exists with this affiliate reference id.",
"fields": [
{
"name": "affiliate_reference_id",
"type": "body",
"value": "XXXXXX"
}
]
}
]
}HTTP 响应代码
400 - 错误请求
在您的请求存在格式错误或包含不正确的值时返回。
代码 400 错误请求表示请求预订标头存在问题。错误响应将在预订请求标头中包含实际的无效错误数组字段。标头由多个数组和 sub-arrays 组成，例如房间和付款。数组整体为正文。因此，body.email 将表示标头正文的电子邮件参数。
注意： 对于住宿 API，预订标头房间数组必须与 Availability 调用中请求的房间数相同。
当请求参数过大时，会返回标有“Tomcat Exception Report”的 400 Bad Request 错误，这种情况最常见于住宿内容和获取房态 API。为避免出现此错误，请减少住宿数量或删除请求中不必要的参数。
响应示例：
不支持的语言：
{
"type": "invalid_input",
"message": "An invalid request was sent in, please check the nested errors for details.",
"errors": [
{
"type": "language.not_supported",
"message": "Language is not supported. Supported languages are: [de-DE, en-US, es-ES, es-MX, fr-FR, id-ID, it-IT, ja-JP, ko-KR, pt-BR, zh-CN]",
"fields": [
{
"name": "language",
"type": "querystring",
"value": "xx-XX"
}
]
},
{
"type": "filter.mismatch",
"message": "Existing booking is expedia_collect, this cannot be changed",
"fields": [
{
"name": "filter",
"type": "querystring",
"value": "property_collect"
}
]
}
]
}缺少版本值：
{
"type": "version.required",
"message": "You have not specified a version, the supported versions are: [1, 2]",
"fields": [
{
"name": "version",
"type": "path",
"value": "missing"
}
]
}无效的版本值：
{
"type": "version.unsupported",
"message": "You have requested a version that is not supported, supported versions are: [1, 2]",
"fields": [
{
"name": "version",
"type": "path",
"value": "3"
}
]
}401 - 未授权
返回 HTTP 授权标头缺失或无法解析的情况。对任何 Rapid Lodging API 的每个请求都必须包含您的 API 密钥 + 共享密钥 + UNIX 时间戳（以秒为单位）的连接后的 未加盐的 SHA-512 哈希。
示例：住宿 API 出现 401 未授权响应：
{
"type": "request_unauthenticated",
"message": "Data required to authenticate your request is missing. Ensure that your request follows the guidelines in our documentation.",
"fields": [
{
"name": "apikey",
"type": "header",
"value": "jaj3982k239dka328e"
},
{
"name": "signature",
"type": "header",
"value": "129d75332614a5bdbe0c7eb540e95a65f9d85a5b53dabb38d19b37fad6312a2bd25c12ee5a82831d55112087e1b"
},
{
"name": "timestamp",
"type": "header",
"value": 198284729
},
{
"name": "servertimestamp",
"type": "server",
"value": 198284729
}
]
}对于 Rapid Flight API 调用，您必须在请求标头中包含有效的 EGToken 主体 JSON Web 令牌 (JWT)。
Authorization: EGToken principal-JWT={encodedJwt}主 JWT 通过 OAuth 2.0 客户端凭证和令牌交换获得。
>> 了解 OAuth 2.0 身份验证
>> 深入了解 Rapid Flight Booking API
403 - 禁止
在您的 HTTP 授权标头有效，却无法访问请求的资源时返回。
403 禁止响应示例：
{
"type": "request_unauthorized",
"message": "Your request could not be authorized."
}404 - 未找到
找不到请求的 API 资源时返回。请对照我们记录的示例来检查您的请求 URL。
住宿地理和内容 API 也使用 404 响应来指示何时无法找到请求的地理文件或 content-specific 文件或资源。有关完整的示例，请参考其相应的文档页面。
>> 查看地理 API 详情
>> 阅读更多关于内容 API 的信息
行程检索后的代码 404 表示未找到预订。如果检索是由于预订错误而进行的，则表示预订并未创建。但是，您需要确保行程检索 API 请求参数有效，因此请确保检索 affiliate_reference_id、电子邮件和/或行程编号正确。此外，如果检索 API 调用与预订调用之间的时间间隔不足 90 秒，我们建议您再次尝试检索。
响应示例：
{
"type": "resource.not_found",
"message": "The requested resource could not be found."
}409 - 价格不匹配
许多供应商采用动态定价，也称为“time-based 定价”。这意味着，定价会根据供需算法而变化。Expedia Group 每秒多次接收更新的速率，这意味着速率会频繁变化。
值得注意的是，这通常是供应商的选择，而不是 Expedia Group 的选择。此外，由于价格和可用性存在多层缓存，因此任何预订都可能存在多层延迟。
价格错配（PMM）是一种预期情况，其发生的原因有很多，包括系统性能下降或系统未能反映更新后的价格。您应该监控这些事件的发生频率，如果发生频率突然增加或达到阈值，请联系支持部门。
如果多个结果同时出现 PMM，则应检查是否存在快速降解的可能性。
如果长时间内对相同的结果返回 PMM，则可能是由于供应商错误加载了费率。您可以联系技术支持进行查询。
要从 PMM 中恢复，请再次调用价格检查（住宿 API）或航班详情（航班 API）以获取新的预订 URL 令牌。之后即可在预订调用中使用相同的 affiliate_reference_id。
响应示例：
{
"type": "price_mismatch",
"message": "Payment amount did not match current price, please check price and try again.",
"fields": [
{
"name": "payments.amount",
"type": "body",
"value": "100.00"
},
{
"name": "price.amount",
"type": "body",
"value": "120.00"
}
]
}410 - 售完或订满
返回当前所访问的 Rapid API 链接已过期或所请求的库存不再可用的情况。
许多供应商与 Expedia Group 有直接、同步的实时通信链路。
同步通信预订是指根据我们管理的供应商数据，对购物可用性和价格进行查询（住宿 API）或航班详情（航班 API）调用。当预订所选库存不足时，就会出现此错误。
这可能只是暂时的，重试一次或许就能找到库存。等待 90 秒，然后使用与预订一起发送的同一个 affiliate_reference_id，通过检索请求检查预订的状态。如果没有找到预订信息，旅客可能需要选择其他方案。
如果与供应商的连接出现故障，也可能出现售罄错误消息。在这种情况下，我们无法得知真实的供应情况。
响应示例：
链接过期：
{
"type": "link.expired",
"message": "The link you followed has expired. Please request a new link."
}订满：
"type": "rooms_unavailable",
"message": "One or more requested rooms are unavailable."426 - 需要升级
返回请求是否未使用传输层安全协议 (TLS)，TLS 是一种取代安全套接字层协议 (SSL) 的加密协议。
响应示例：
{
"type": "upgrade_required",
"message": "This service requires the use of TLS."
}429 - 速率限制错误
当请求计数超过速率限制时，将返回 429 状态代码。每个请求可能会受到两种不同的速率限制的制约：当集成以超过限制的速度发送请求时的速率限制，以及当 Expedia Group 服务器遇到负载超限时的速率限制。
当您发出 Expedia Group API 请求时，接收服务器会检查请求计数是否在限制范围内。如果请求计数在限制范围内，该请求会通过，并且客户端的计数会增加。如果客户端请求计数超过限制，则服务器会返回包含 HTTP 429（请求过多）状态代码的响应。
服务器可以选择性地包括 Rate-Limit-Day-Reset 和 Rate-Limit-Minute-Reset 标头。这表示在发送下一个请求之前您应等待的时间。它们是下一次发生滚动时的时间戳，单位是微秒（不是毫秒）。
例如，当转换为日期/时间时，数值“15489792000000”的结果是 Friday, February 1, 2019 12:00:00 AM（UTC）。
**注意：**如果您收到请求过多的错误，请至少等待 5 分钟，然后再尝试更正的请求。更频繁的重试会引起因缓存时间而产生的重复故障。
响应示例：
HTTP/1.1 429 Too Many Requests
Connection →keep-alive
Content-Length →106
Date →Fri, 01 Feb 2019 06:20:51 GMT
Rate-Limit-Day-Remaining →18
Rate-Limit-Day-Reset →1548979200000
Rate-Limit-Minute-Remaining →0
Rate-Limit-Minute-Reset →1549002000000
Rate-Limit-Reduction-Status →inactive
Server →EAN
Transaction-Id →003224d2-1407-42fe-8bf8-6d74226e7f00500 - 内部服务器错误
返回 Rapid API 或上游系统中的错误。如果给出了具体操作，请按照消息字段中的说明进行操作，否则，只需再次尝试使用相同的 affiliate_reference_id 发出请求。
Rapid API 检测到问题但无法更具体地说明具体问题是什么时，会返回 HTTP 500 错误。所有合作伙伴在使用 Rapid API 时都会不时收到 500 错误代码响应。
使用不支持的销售网站（如叙利亚）也可能会发生 HTTP 500 错误。
如果您在除创建预订或取消预订以外的 API 响应中收到错误，并且没有已知的降级，则请稍后重试您的请求。响应可能会包含一个 Retry-After 标头，指明再次尝试前的最短延迟时间（以秒为单位）。
如果您在创建预订时收到 API 响应中的错误：
- 等待 90 秒，然后使用与预订一起发送的同一个
affiliate_reference_id，通过检索请求检查预订的状态。 - 如果找不到预订或持续收到 500 错误，请稍后再试预订。
如果您在取消预订时收到 API 响应错误：
- 等待 90 秒，然后使用已知的
itinerary_id，通过行程检索请求检查预订的状态。 - 如果预订未能取消或您持续收到 500 错误，请稍后重试取消请求。
响应示例：
{
"type": "unknown_internal_error",
"message": "An internal server error has occurred."
}{
"type": "internal_error",
"message": "An internal server error has occurred. Please discard any previously received results in this pagination and restart the pagination from the beginning."
}503 - Service unavailable
HTTP 503 错误通常是暂时的，表示 Rapid API 或下游服务当前无法处理请求。造成这种情况的原因有很多，从暂时过载到与供应商的连接中断都有可能。
如果您在“创建预订”或“取消预订”以外的 API 响应中收到错误，并且没有已知的性能下降，请稍后重试您的请求。响应可能会包含一个 Retry-After 标头，指明再次尝试前的最短延迟时间（以秒为单位）。
如果您在创建预订时收到 API 响应中的错误：
- 您之前通过价格查询（住宿 API）或航班详情（航班 API）获取的预订链接会在短时间内过期。如果您在首次尝试后收到 HTTP 503 错误，则该链接可能已失效。请获取新链接并再次尝试进行预订。
- 如果您在第二次尝试时收到 503，请等待 90 秒，然后使用与预订一起发送的同一个
affiliate_reference_id，通过检索请求检查预订的状态。 - 如果未找到预订或持续收到 503 错误，请稍后重试预订。
如果您在取消预订时收到 API 响应错误：
- 等待 90 秒，然后使用已知的
itinerary_id，通过行程检索请求检查预订的状态。 - 如果预订未能取消或您持续收到 503 错误，请稍后重试取消请求。
响应示例：
{
"type": "service_unavailable",
"message": "This service is currently unavailable."
}504 - 网关超时
HTTP 504 错误通常不是来自 Rapid API，而是来自云或边缘基础设施，表示网络基础设施中的某个项目（例如负载均衡器）在事务处理期间发生故障。这通常是一种暂时性的事件。
注意： 超时可能发生在行程创建之前或之后，因此请务必检查行程是否已创建。
HTTP 504（和 502）错误响应采用 HTML 格式，而不是 Rapid API 的 JSON 类型/消息对象对。这进一步表明这些错误并非由 Rapid API 生成。
响应示例：
<html>
<head><title>504 Gateway Time-out</title></head>
<body>
<center><h1>504 Gateway Time-out</h1></center>
</body>
</html>房价错误响应的限值标准
为了确定您自己的阈值，您应该测量以下响应代码的每日发生率：409、410、500、503 和 504。如果超过阈值，请联系 Rapid API 支持。
Expedia Group 没有设定阈值，因为它们会根据贵组织的市场以及其他因素而变化。了解市场对于确定某些错误反应发生的原因至关重要。我们的指导意见是，预计每天或每周将有 5-6% 的预订电话因代码 50x 错误而失败。
随着时间的推移，你应该能够计算出自己的阈值。不要只关注每日突然增加的情况——即使阈值设定为每天 5 次，例如，在 5 分钟内连续出现两次 500 错误，也可能是需要向 Rapid API 支持部门咨询的原因。
日志
如果 Rapid API 支持团队要求提供请求/响应日志，请尝试提供以下内容：
- API 响应标头中的
Transaction-Id值。这对深入调查至关重要。 - API 请求和响应日志。请求日志应包括所使用的完整端点 URL。响应日志应该包括返回的 HTTP 代码、完整的响应数据和返回的任何标头。
- 参数为
point_of_sale的房态 API 请求以及房态响应。这将允许支持人员识别正在使用的 Rapid API 帐户和配置文件。 - 每个预订请求的预订 API 请求头和授权头（包含 API 密钥、签名和时间戳）。
- 请求日志中的预订请求 URL 和令牌。
- 无论预订调用是成功还是失败，行程检索均在预订 API 调用后发出。
请包括完整的 JSON 请求和响应。JSON 字符串必须是 double-quoted，因此无需在 double-quote 字符前添加反斜杠转义字符。
| 正确的 Json 代码 | 错误的 Json 代码 |
|---|---|
json "id": "208646250", "status": "available", | json\"id\": \"208646250\", \"status\": \"available\", |
只有当需要双引号成为字符串的一部分时，才需要在双引号前面使用反斜杠转义字符。
响应示例：
"spokenwords": "He said \"hello world\""注意： 请勿将日志转换为 PDF 格式。Expedia Group 支持有时会将日志数据复制/粘贴到内部工具中，而 PDF 格式会在数据中添加不必要的行字符。
附录
例如，某个预订尚未快速解决。
已确认预订示例
预订失败示例
