问：有政策投入渠道还能接入API直连吗？

答：通过API直连的方式接入，和政策投入是两个不同的渠道，并不冲突，也就是说，可以1个店铺，既有政策投放，又做API直连。

 

问：接口中的CID接口用户标识，从哪里获取？

答：CID 由商户提供给BD/运营同学配置到后台，用于接口调用时辨识请求来源，自测时目视检查界面显示的与商户自己系统配置的一致，默认会显示到自测cid输入框内，也可手动复制当前接口的cid到相应输入框内，线上运行时以后台配置为准。

  

问：接口中的token从哪里获取？

答：token为16位数字字母组合，用于加密接口的加密和解密，由商户提供给BD/运营同学配置到后台，自测时目视检查界面显示的与商户自己系统配置的一致，自测和线上运行时都以后台配置为准。

 

问：接口超时有什么限制？

答：

• 每个接口超时限制都是一致的：连接超时3秒，总超时时长25秒。
• 一般质量较好的渠道都会把接口响应时长控制在6-9秒内，搜索接口响应时长会控制在2秒内。
• verify和pay接口响应超过6秒往往会造成无线端调用失败。
• 可支付校验响应超过6秒在无线场景会导致买家无法支付，请务必设法控制，如果这个指标无法保证，请联系运营设置仅在PC端售卖。
• 搜索响应时长过长，会导致搜索接口并发访问量过大，容易导致搜索请求被并发量限制拦截，可以通过自有系统搜索缓存等方式加以优化。

 

问：搜索查询接口多少秒内返回数据是有效的，每秒或没小时查询量是多少？

答：搜索接口理论上25秒内返回都是有效的。查询量与渠道搜索配置的航线白名单覆盖范围、返回运价的成功率、接口响应时长、搜索结果缓存时长都有关系。

 

问：搜索接口有并发请求数量限制吗？

答：

• 搜索接口会设置保护性的并发数量限制，超过并发数量限制的会被系统拦截掉，不会调用搜索接口。
• verify、order、pay接口一般不设置并发数量限制，如果商户接口有特殊保护要求，可向客户经理声明需要设置并发数量保护。
• 如果搜索接口响应时长比较长，往往会造成请求数量超过并发限制导致搜索请求被拦截、搜索接口成功率降低。
• 请设置好航线白名单，避免过多无效调用占用搜索并发数量。
• 如果只销售单程或者往返的产品，可以在“API接口状况”界面点击对应渠道的“查看搜索配置”，自助配置售卖行程类型。可避免无效的搜索请求调用占用搜索并发数量。
• 如果只销售固定日期范围的产品，譬如只销售3天之后的机票，可以在“API接口状况”界面点击对应渠道的“查看搜索配置”，自助配置销售日期范围。可避免无效的搜索请求调用占用搜索并发数量。
• 每个渠道的搜索并发数限额，可以在“API接口状况”界面点击对应渠道的“查看搜索配置”查看。

   

问：支付的时候的请求参数 用的是生单返回 的 价格还 是 请求生单时候 的价格 ？

答：

• 以verify接口调用后的成人票面+成人税费价格 减去 搜索成人票面+成人税费价格 的差价来判别：
• 绝对值20元之内以搜索为准；高于20元的提示客户是否接受，接受的按验价结果价格，不接受的就会验价失败不生单；低于-20元的按验价结果价格。
• 在生单接口不接受变价，如果有变价请直接返回失败，不返回失败的以验价时候确定的价格生单成功。

 

问：加密过程是针对请求或者返回的数据整体JSON进行。还是针对参数对应的值进行AES加密？

答：order接口和pay接口，会做整体加密解密。

 

问：搜索search，校验verify，生单order，支付pay，是否均进行加密？文档第五条没说搜索是否加，那搜索是否也加？另外，我们之间的请求交互是否均为双向加密传输？

答：仅生单order、支付pay接口加密，加密为双向的。请勿对search接口和verify接口的返回信息加密。

 

问：为什么接口正常在线，从某个时间开始没有搜索请求了

答：

• 接口是否在线目前是以前N天的质量表现评测的，具体规则参考线上的下线规则。
• 没有搜索请求时，请对照航线城市白名单，不在白名单中的不会有搜索请求。
• 请检查错误数据报表，是否有相应航线的验座无座、验价失败、生单失败、支付校验失败，这些失败都可能导致对应搜索条件被加入黑名单屏蔽搜索1个小时，相应的也不会有展示。
• 请检查店铺的工作时间是否正确设置，如果设置不正确，也不会有搜索请求。
• 如果以上原因都已经排除，请联系客户经理或运营同学，沟通下是否当前店铺可出票航段数已经到达上限。

 

问：接口对航班号有格式要求吗？

答：

• 航班号有格式要求：航司二字码后面是3位或者4位数字。
• 请将数字部分不满3位的补0成3位数字，譬如CI6，需要补齐后在接口传CI006。

 

 问：为什么平台展示其它卖家店铺的价格，我们店铺的价格实际更低

答：

• 请用接口自测工具验证搜索接口即时返回的价格是否与商户自有系统内价格一致。
• 接口自测工具价格比线上其它家实际要低，请点击“线上不展示排查”链接查看具体不展示原因。
• 如果不展示原因是“价格高”，请联系BD和运营同学，适当调整搜索接口结果的缓存时间长度设置。
• 有些供应商能提供“留学生”这类价格，这类特殊票种的价格有单独的坑位。公务舱、特殊年龄段也有单独的坑位。
• 有些是投放了金牌服务、极速出票等产品，有独立的坑位。如果店铺有做金牌服务、极速出票的能力，请联系联系BD和运营同学。
• 特别注意：某些商户自有系统搜索接口返回的航班和价格依赖于自己的缓存，当缓存失效时可能返回默认结果，这种场景下请不要将无价格优势的作为默认结果迅速地返回，会导致平台始终缓存了一个没有优势的政策、无法重新去获取更有竞争力的政策。

 

问：为什么搜索界面展示价格和接口即时返回价格不同

答： 当搜索页面展示价格和接口显示不同时：请检查接口是否返回一舱多价，目前不支持一舱多价的全部价格；如果缓存时间比较长，也会有接口即时价格与搜索页面价格不同。

 

问：为什么搜索时有些航线不展示

答：

• 如果某个航线内，有平台不支持的机场码、有申请价（ApplyType=1）、成人票面或者税费价格错误、有包含税的成人价（AdultTaxType=1）、去程或者回程段数大于2、有空铁联运、有巴士、去程回程机场日期和搜索条件对应的城市日期不一致，或者是出票和共享航司受限、中转时间过短、起飞时间过近、价格高、命中黑名单（之前有变价、无座、生单失败、可支付校验失败）、平台验舱等等都将导致不展示。
• 具体可以使用不展示排查工具自查，也可用“错误数据查询”功能排查。
• 如果不展示排查工具显示无价格，请检查搜索结果对应航司的舱位是否特殊舱位，譬如包机切位的指定舱位可能无法通过平台验舱，如果是这种情况，请联系客户经理和运营。

 

问：平台的搜索和缓存策略是怎样的

答：

• 平台的搜索依赖于缓存。有买家搜索某个航线后，商家搜索接口返回的有效报价会缓存一段时间，缓存有效期内买家再搜索就不会再调用商家搜索接口。如果没有针对渠道做单独配置，会用默认设置，即以3小时为缓存有效时长。
• 热门航线价格稳定有优势的可以不单独配置缓存时长，频繁的预定会触发搜索去更新搜索缓存。
• 如果变价比较频繁请与运营沟通，单独设置渠道的缓存时长，以免政策无法及时更新，造成价格高不展示、或者展示后检验有变价被关黑名单。
• 对于冷门航线，如果缓存时长过短也会导致展示率低。
• 除了让运营配置渠道指定缓存时长，也可在搜索结果通过validTime参数指定当前航线报价的缓存时长。建议近期、热门航线适当设置短一些，远期、冷门航线适当设置长一些，避免都设置过短导致搜索并发量过大被平台主动拦截搜索请求。
• 指定缓存时长并不意味着到间隔固定时间一定会调用搜索接口，所有接口调用都基于买家真实的搜索行为，同时与商家渠道历史质量表现、缓存是否存在有效数据、商家渠道航线白名单设置、商家渠道并发数量限制等多种因素有关。
• 每个渠道的默认缓存时长设置，可以在“API接口状况”界面点击对应渠道的“查看搜索配置”查看。

 

问：为什么验价价格和搜索价格一致也会验价失败？

答：目前大卖家接口不支持成人税费为0的验价场景，会导致验价失败、禁止下单。请勿投放此类运价。

 

问：为什么要配置航线白名单？如何配置？

答：

• 配置航线白名单后，只有在配置中存在的航线才会调用搜索接口，可减少无效调用、较少搜索并发请求量、提高搜索有效率。
• 航线白名单仅支持配置城市对，对于往返程需要配置两个城市对。具体要求请参见“航线白名单配置”页面说明。

 

问：为什么低价扫线看不到自己店铺的价格？

答：低价扫线显示的价格有平台最低价和自己店铺的公布运价，自己店铺价格显示列不包含直连API方式接入的价格。

 

问：为什么自测工具验证所有接口都正常，在线上的可支付校验接口失败率特别高（商家自有系统没有接收到所有可支付请求）？

答：请调整服务器端设置的关闭连接策略。目前所有接口默认设置连接超时3秒，读超时25秒，接口连续调用时平台系统会默认使用现有的连接，如果商家服务器端设置每次返回数据后立即断开连接，平台紧接着调用第二个接口时就会发生NoHttpResponseException。

 

 

问：请问验价失败之后会立即清除改航线的缓存吗？

答：验价会立即触发刷新航线的缓存，但验价失败会立即屏蔽掉这个航线的搜索展示，如果之前已经有买家进入到订单填写页面了，那么买家流程继续，不受搜索屏蔽的影响。

 

问：搜索缓存数据只能是点击之后清除吗？

答：除了搜索缓存过期会重新调用商家接口刷新，也可通过推送接口主动刷新报价，推送接口参见：//open.taobao.com/doc2/apiDetail.htm?apiId=29496

 

问：调用verify接口进行座位数校验时，接口返回成功且座位为0或变舱的比例。验座无座率应小于10%，是基于什么统计的？

答：

返回成功次数为分母，最小座位数量为0、以及舱位变更的报价次数为分子。
只有返回有效报价，是否有座、是否变舱、是否变价数据才算，如果报价都没有返回，就是无效数据了。
接口上面的表现就是： status = 0 maxSeats > 0 ，并且必须要有 有效的 报价返回。

问：直连搜索接口在自测工具可以正常搜索到价格，为什么价格在慧飞后台比价工具不展示，或者出现平台拿着1个小时前的搜索接口数据去请求验价接口导致商家验价失败？

答：缓存原因导致，比价工具展示的不是商家的实时数据，是缓存数据，缓存失效之后比价工具就不展示了，平台会不断的请求商家的搜索接口拿到最新的数据做

缓存，请求的qps越大，缓存时间越短，可以联系研发小蜜进行调整请求的qps。也可以通过报价推送接口推送报价推送接口参见：//open.taobao.com/doc2/apiDetail.htm?apiId=29496。

问：商家直连接口因失败率过高下线会有通知吗？

答：可以联系研发小蜜，在对接群里配置下线预警机器人，也可以邮箱下线通知也会发送到商家的邮箱中。

其他问题：

https://open.alitrip.com/docs/doc.htm?docType=1&articleId=109180

 

 

FAQ

关于此文档暂时还没有FAQ