> For the complete documentation index, see [llms.txt](https://resources.atriptech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://resources.atriptech.com/bang-zhu-zhong-xin/chang-jian-wen-ti/api-ji-cheng-xiang-guan.md). # API集成相关 **问题1： 沙盘环境中提供了哪些航空公司和城市对？** 答：您可以在沙盘环境下测试功能。Atlas提供多家航空公司的航线，以确保您可以测试各种场景。您可以在API文档（([link](https://www.atriptech.com/#/document/list) ）中找到可用的航空公司和航线信息。具体路径为：API参考→ Atlas 沙盘→沙盘测试航线。 **问题2：可以根据需要在沙盘环境中添加特定航空公司吗？** 答：您可以在Atlas的沙盘环境下测试功能，有多家航空公司的航线可以用来测试，确保可以测试到各种场景。在API文档（[link](https://www.atriptech.com/#/document/list) ）中可以找到航空公司和航线信息。路径：API技术文档→ Atlas沙盘测试→沙盘测试航线。 当然，如果您希望测试特定航空公司或航线，请随时告知我们您的测试场景。我们的团队将及时回应您的请求。 **问题3：可以同时创建包含9名乘客的订单吗？** 答： 许多航空公司不会提供特定票价的最大可选座位数。为了保持较高的预订成功率，Atlas 默认情况下允许最多为4名乘客创建订单。根据客户需求和航空公司的能力，Atlas已经将部分航空公司的最大座位数增加至9个。如果您需要为特定航空公司启用此功能，请告知我们，我们的团队将及时处理您的请求。 **问题4：谁会协助客户进行API集成？** 答：我们将发起一次启动会议，来对整个集成的过程进行介绍。客户解决方案和销售负责人将为您提供支持。 **问题5：Atlas提供了哪些不同的API用于集成？** 答：请参阅ATRIP中的API文档，其中列出了所有可用的API。 **问题6：能否提供Atlas的API列表？** 答：请参阅ATRIP中的API文档，其中列出了所有可用的API。 **问题7：Atlas API的沙盘环境端点是什么？** 答：[https://sandbox.atriptech.com](https://sandbox.atriptech.com/) **问题8：API文档中的display currency（展示货币）是什么意思？** 答：此货币及相关金额是根据Atlas货币汇率从结算货币转换而来的。此金额仅供参考，不用作比价或结算目的。 **问题9：在搜索API响应中，是否展示免费的手提和托运行李信息？** 答：是的。搜索API、校验和生单响应都会展示手提和托运行李信息。请参考“baggageElements”标签。 **问题10：在集成Atlas API的环节，将向客户提供哪些支持？** 答：我们将分配一个项目小组来支持客户集成Atlas API。客户可以选择想要的平台（例如Slack）进行整个集成过程的沟通。该平台上将提供多种资源。 **问题11：在接入Atlas的API后，将向客户提供哪些支持以确保达到预期的最佳结果？** 答：API集成后，Atlas的增长团队将客户的增长团队合作，以增加交易量。与此同时，如果您对集成有任何问题，请随时联系我们。 **问题12：Atlas在搜索请求中会返回多少条记录？按什么规则排序？** 答：我们对响应记录进行了后端配置，默认情况下会有100条记录，按票价从低到高排序。 **问题13：可否对搜索结果进行筛选？** 答：客户可以在search.do搜索请求中使用“airlines”element对搜索结果进行筛选。最多支持筛选5家航空公司。 **问题14：Atlas是否提供带有乘客限制的特殊票价？** 答：目前不支持带有乘客限制（如年龄和国籍）的特殊票价。 **问题15：“TransactionFeePerPax”是什么意思？** 答：“transactionFeePerPax”字段是一个历史字段，请忽略它。目前它已经被以下两个element取代：“transactionFee”（客户和Atlas之间协商的费用），“TransactionFeeMode”（根据合同协议计算交易费用的标准）。 **问题16：搜索响应中的座位数量是什么功能？** 答：我们尽最大努力为客户提供最优票价。因此，我们会根据能提供最低价格的座位数量来收集票价，也就是说：在单次预订中以该价格能预订到的最大座位数量。 **问题17：为什么API响应中缺少税费明细？** 答：我们从航空公司网站的机票搜索页面收集票价。但许多低成本航空公司在其搜索响应中并不会展示税费明细。因此，在我们的search.do响应中也没有提供这些信息。 **问题18：从搜索到重新校验环节，允许的最大时间间隔是多长？** 答：routingIdentifier有效期为2小时。请注意，最好尽早验证票价，因为时间间隔越长，票价变动的可能性就越大。 **问题19：从重新校验到生单环节，允许的最大时间间隔是多长？** 答：sessionID的有效期为30分钟。请注意，最好尽早下订单，因为时间间隔越长，票价变动的可能性就越大。 **问题20：订单锁定功能发生时会发生什么？** 答：我们没有“订单锁定”功能。在订单生成后，我们提供30分钟的时间来完成支付。 **问题21：order API调用后是否会锁定库存？如果会的话，释放库存的机制是什么？** 答：我们提供30分钟的支付时间窗口，你可以将其视为“锁定”功能。我们与航空公司合作，在后端管理此功能，为客户提供最优惠的价格。在Atlas调用Order API后（如果航空公司支持），我们会锁定库存，同时也有一套释放库存的机制；但会根据航空公司的实际支持情况来提供锁定或释放库存的功能。这不会影响您与Atlas的交易。 **问题22：如何获取测试API凭证？** 答： 可以在ATRIP的“Profile”模块创建沙盒环境的API凭证。路径是：ATRIP -> Profile -> My Profile -> Company Information -> 点击“Generate”按钮。链接为：。 **问题23：Atlas是否可以按用户请求的货币获取票价？** 答：目前，我们是按照与客户结算的货币（交易货币）提供搜索结果。但我们添加了一个新参数：displayCurrency，用于转换成客户选择的任何货币。此处转换的金额仅供参考，以实际金额为准。 **问题24：除了搜索和校验API响应外，如何获取特殊服务信息（如餐食、行李、座位图）？但是这些信息会增加响应的数据传输量，是否可以控制此类信息不传递到搜索响应？** 答：目前，Atlas在出票流程中提供两种附加服务：行李和座位。行李信息在搜索和校验响应中都可以获取到，并且无法移除。至于数据量大小方面的担忧，可以通过GZip压缩来缓解这个问题；关于座位，我们有专项功能来提供座位图和座位可用性等信息，此功能只能通过校验API来调用。 **问题25：order API会锁定库存吗？** 答：我们没有“库存锁定”功能。在订单生成后，我们提供30分钟的时间来完成支付。 **问题26：客户可以锁定库存吗？如果可以，释放库存的机制是什么？** 答：我们提供30分钟的支付时间窗口，你可以将其视为“锁定”功能。我们与航空公司合作，在后端管理此功能，为客户提供最优惠的价格。在Atlas调用Order API后（如果航空公司支持），我们会锁定库存，同时也有一套释放库存的机制；但会根据航空公司的实际支持情况来提供锁定或释放库存的功能。这不会影响您与Atlas的交易。 **问题27：在查看航段元素（Segment Element）的Schema时，为什么一些关键节点如预订舱位（booking class）、票价基础（fare basis）等缺失？** 答：我们从航空公司网站的机票搜索页面上收集票价。但许多低成本航空公司在其搜索页面上并不会展示所有的航班和票价信息。因此，您在GDS中获得的很多信息可能不适用于低成本航空公司。Atlas用于获取预订舱位（RBD）的API Element是“cabin”。 **问题28：客户能否通过修改订单API来进行PNR取消、部分取消、添加额外服务（例如餐食、行李和座位）等操作？** 答：目前，通过我们的API和ATRIP平台都支持售后行李和退票功能。我们也在一直完善功能，会陆续增加更多功能。 **问题29：能否查询航空公司的实时库存？** 答：能。我们支持实时搜索API。我们会在了解并考虑您的流程和需求之后提供访问权限。更多信息请参阅： 。请跳转至“实时搜索”API部分。 **问题30：在搜索API中是否包含信用卡附加费用？** 答：我们已经进行了详细分析，并了解到不同航司适用的附加费用。在适用的情况下，信用卡附加费用会被添加到票价的总价格中，并包含在`search.do` API请求中。 **问题31：您使用哪种外汇汇率将POS货币价格转换为与Atlas达成协议的货币设置？** 答：我们使用Mastercard的汇率将货币转换为交易货币。 **问题32：Atlas的预订成功率是多少？** 答：Atlas目前的预订成功率达97%，都是通过缓存结果实现。这意味着在100次预订中，平均只有3次会在出票阶段出现票价变动。 **问题33：在一段时间（2-24小时）后，是否可以重复使用相同的路由标识符（routingIdentifier）来重新定价？** 答：抱歉，目前暂无此功能。如果您需要在初始搜索之后的一段时间后确认预订，则需要再次进行搜索，重新校验并从航空公司获得当前价格。 **问题34：供应商货币是否始终与始发地的货币保持一致？** 答：供应商货币是Atlas向航空公司支付的货币，在Atlas接受客户使用VCC支付方式的API响应中，供应商货币是可用的。然而，该货币并不总是与行程起始点的货币相同，其逻辑取决于：1）航空公司航线的原始定价；2）一些Atlas不支持的货币会被转换为支持的货币。 **问题35：是否支持带有账号/公司编号的定价？** 答：目前我们不支持此功能。可以提供具体的用户场景吗？我们的团队将对其进行评估并回复您。 **问题36：是否支持联程航班？** 答：是的。我们支持航空公司航线列表中提供的所有航班。 **问题37：是否支持缺口程、多城和环程机票？** 答：目前我们不支持缺口程、多城和环程机票。 **问题38：是否支持在单笔交易中混合选择不同航空公司（例如LS+ G9）？** 答：一般来说，我们不支持混合选择航空公司。但是对于往返搜索，我们可以配置单程+单程的票价，如果它们比往返票价更便宜的话。 **问题39：是否支持信用卡支付？** 答：是的。我们支持信用卡透传的支付方式，也就是将您的信用卡信息直接发送给航空公司来进行支付。航空公司可能对有些信用卡有限制，因此支付可能会被拒绝。 **问题40：在搜索响应中是否显示联程航班？** 答：是的，可以搜索到联程航班。 **问题41：Atlas是否支持婴儿乘客类型？** 答：是的。Atlas支持婴儿乘客类型。但可能有少数航空公司不支持，该信息将在搜索响应的“infantAllowed”字段中展示。 **问题42：Atlas Schema的格式是什么？** 答：Atlas Schema是JSON格式的RESTful API。 **问题43：Atlas是否提供可用于Postman的API用例？** 答：是的。您可以从Atrip平台上下载Postman接口用例，下载路径：Atrip → API文档 → API技术文档 → Atlas沙盒 → UAT提交指南。 **问题44：在沙盒环境中通过VCC支付创建预订时，需要使用哪些信用卡信息？** 答：在沙盒环境中可以使用任何虚构的VCC信息来创建预订。 **问题45：Atlas是否支持票价套餐/捆绑？** 答：我们目前不支持票价套餐/捆绑。但是正在开发这一产品，预计将于2025年发布。如果您不介意，请和我们分享您使用票价套餐的用户场景？ **问题46：是否会检查重复预订？如果有，是Atlas还是航空公司来检查？** 答：我们会检查重复预订。在Atlas系统里，我们会把过去10天内创建的订单的PNR与当下的PNR做比对，检查是否有订单重复的情况；这有助于减少出票过程中的错误。。 **问题47：Atlas如何创建联程航班的行程选项？是根据最短转机时间（等待时间最短）吗？还是最便宜的价格？以及是否会根据筛选条件过滤一些选项？** 答：我们并不会在系统中自行创建联程航班的行程选项，而是通过搜索采集所有航空公司提供的行程选项。 **问题48：Atlas是否会比较订单履行时返回的价格与验价接口返回的价格？** 答：是的，我们会比较生单时的价格与验价时候的价格。 **问题49：如果存在价格差异，Atlas会怎么处理？会报错并阻止交易吗？** 答：Atlas将取消预订并发送错误代码“308（价格变动）”。如果客户已与Atlas协商要求在取消订单前联系其运营团队，我们将通过首选的沟通方式与其联系。 **问题50：SEARCH接口返回的交易费用是什么？** 答： "transactionFee"是客户和Atlas之间协商的费用。此金额应结合“TransactionFeeMode”来理解。注意：“transactionFeePerPax”字段是一个历史字段，请忽略。 **问题51：航班选项及其库存是否是缓存数据？** 答：是的，Atlas拥有强大的缓存机制，成功率高且响应速度快（低于500ms）。因此，我们基于缓存数据提供可选航班和库存。 **问题52：如果在验价时没有座位可选（所有座位售罄），会出现什么情况？** 答：Atlas将发送错误代码“无航班”。您可以参考我们的API文档中列出的错误代码：ATRIP → API文档 → API参考 → 概览 → 错误代码。跳转链接： **问题53：如果在验价时可选票价售罄，只剩下更贵的选择，会出现什么情况？** 答：价格变更信息会在验价请求返回的“priceChange”字段中展示出来。 **问题54：信用卡支付费用如何处理？这些费用会被加到票价上吗？** 答：我们已经进行了详细分析，并了解到不同信用卡适用的附加费用。在适用的情况下，信用卡附加费用会被添加到票价的总价格中，并包含在`search.do` API请求中。 **问题55：如何确定预订请求中的哪些字段是强制性的？** 答：预订请求中所需的必填信息将在验价接口返回值的bookingRequirements字段中展示。我们有一个内部表格，会定期检查航空公司的要求并进行更新。 **问题56：是否需要为所有乘客类型添加护照信息？** 答：是的，如果护照信息在验价响应中的预订信息中被标记为“必填”，则需要为所有乘客类型添加上该信息。必填信息会在verify.do接口返回值的“bookingRequirements”字段中展示。 **问题57：VCC透传的pay.do请求中的所有字段是否都是必填的？** 答：是的。这些字段被设置为“必填”，因为有些航空公司需要提供完整的信息来完成支付。由于航空公司的政策可能会随时变化，因此无法确定哪些航空公司需要这些信息。 **问题58：为何在沙盒环境中会出现超过10分钟还未出票的情况？** 答：沙盒环境适用于多种测试场景，可能会出现超过10分钟还未出票的问题。有时候需要人工手动出票。 **问题59：在哪些情况下可能会出现多个航空公司PNR代码？** 答：为了提供最低票价，我们可能会组合两家航空公司的航班来提供最便宜的往返程。由于行程涉及两家不同航司，因此将会展示两家航司的PNR代码。 **问题60：我们可以再次使用相同的订单号发送订单请求吗？** 答： 一旦订单创建完成，便无法进行修改。如果提交了包含相同信息的新订单，它将因重复订单而被拒绝。您必须等待原始订单过期后，才能提交新的订单。 **问题61：联系电话的格式是什么？** 答：请按照以下格式：XXXX（数字国家代码）- XXXXXXXX（电话号码）。例如：0001-87291810，0086-13928109091，0971-19201998。此字段的字符限制为30个字符（包括连字符）。 **问题62：Order响应中的tktLimitTime是什么？它有什么影响？** 答：tktLimitTime定义了订单需要在多长的时限内完成支付。该时限采用的是新加坡时间（SGT）。如果未在此时间内完成支付，预订将失效。 **问题63：在与Atlas合作之前，我们可以测试API功能吗？** 答：可以。您可以在正式合作前测试Atlas的API功能。请填写联系表单，我们将在两个工作日内与您联系。为了保护我们的合作航司，我们需要确认您的详细信息并请您签署保密协议（NDA）。验证通过后，测试凭证将发送至您的邮箱。 **问题64：对任何航空公司的API功能是否有任何限制？** 答：我们努力为我们的合作航空公司和旅行社提供更丰富的功能支持。随着更多新功能的集成，航司将会逐步增加更多功能。 **问题65：Atlas是否支持促销票价或基于促销代码的定价？** 答：我们目前提供通用的促销票价功能，但默认不支持促销代码。我们可能只针对某些特定航司支持此功能。如果您想了解更多，请留言，我们将与您联系。 **问题66：Atlas的API是否有超时限制？** 答：有的，超时限制如下： * Search.do：未定义限制 * RealTimeSearch.do：120秒 * Verify.do：15秒 * Order.do：正常预订15秒，实时预订120秒 * pay.do：未定义限制 **问题67：Atlas的每个API的响应时间是多少？** 答：平均响应时间如下： * search.do：小于500毫秒（98%的请求在500毫秒内返回） * realTimeSearch.do：25秒 * verify.do：8秒（90%的请求在8秒内返回） * order.do：8秒（90%的请求在8秒内返回） * pay.do：2秒（90%的请求在2秒内返回） **问题68：是否支持用户切换成本地货币来查看机票价格？** 答：可以。客户可以在搜索和验价API中使用displayFare参数来获取他们所选择的货币的金额。此金额仅供参考，实际支付的金额可能会有所不同。 **问题69：搜索查询会返回多少结果，以及默认的排序顺序是什么？** 答：默认情况下，搜索查询会返回多达100个结果，按照票价从低到高排序。 **问题70：订单API会保留库存吗？如果会，会保留多长时间？** 答：会的，订单生成后将会保留库存30分钟。在此期间必须完成支付。 **问题71：我们可以释放我们持有的库存吗？** 答：库存是在后端进行管理的。我们会将库存锁定30分钟，但目前没有提供按需释放库存的功能。这不会影响您与Atlas之间的交易。 **问题72：Atlas在维护API连通性上的义务是什么？** 答：我们保证API连通性达到99.9%。 **问题73：Atlas是否有监控性能并触发通知至Sabre的流程？** 答：有的，我们全天候监控供应商（航空公司）。如果供应商的API质量达不到预期，我们会在搜索API中禁用该供应商定价，同时继续监控其API质量。 **问题74：Atlas针对GDPR和PCI DSS采取了哪些数据保护措施？** 答：Atlas同时符合PCI DSS和GDPR标准。 **问题75：Atlas采取了哪些安全标准以防止违规？** 答：Atlas使用阿里巴巴云容器服务，并遵循阿里巴巴云的安全最佳实践。我们还使用GCP容器，并遵循GCP的安全最佳实践。 **问题76：Atlas是否有容灾处理方案？** 答：我们采用了三个数据中心的“多节点全活动”模式，降低了客户数据丢失的风险。 **问题77：当Atlas API或服务不可用或受影响时，解决错误的服务等级协议（SLA）是多少？** 答： * 严重性1：30分钟。 * 严重性2：3小时。 * 严重性3：24小时。 * 非关键问题：2天。 **问题78：在哪里可以找到API文档？** 答：Atrip上有完整的API文档()。 **问题79：Atlas是否提供监控控制台/仪表板？** 答：有的，Atlas有展示航段信息的仪表板，而且还在不断增加更多功能。 **问题80：如果API发生故障，是否有其他备用方案可以创建预订？** 答： 目前没有，不过我们正在探索未来通过Atrip Flight Deck进行预订的可能性。 **问题81：如果遇到API故障，我们应该怎么做？** 答：您可以登录Atrip进行售后服务，或联系API支持团队。