驴妈妈旅游网分销API接口文档

5星 · 超过95%的资源 需积分: 32 71 下载量 8 浏览量 更新于2024-07-22 收藏 1.03MB PDF 举报
"驴妈妈网分销接口" 驴妈妈旅游网分销API接口是一套用于旅行社、旅游平台等分销商与驴妈妈旅游网进行系统对接的技术规范,旨在实现自动化的产品信息获取、订单处理以及信息推送等功能,提高业务处理效率。该接口文档详细介绍了各个功能模块及其操作方法。 1. **引言** - 修订记录:文档经过多次修订和完善,包括创建、修改等阶段,以确保信息的准确性和时效性。 - 产品API交互图:展示了分销商系统与驴妈妈旅游网系统之间的数据交换流程。 - 名词解释:定义了接口中涉及的专业术语,帮助理解和使用接口。 - 分销商开通分销渠道接口:说明了分销商如何开启与驴妈妈的分销合作,并接入相关接口。 2. **产品信息接口** - 产品基本信息列表接口(productInfoList):允许分销商获取驴妈妈旅游网上的多款产品基本信息,如名称、描述、图片等。 - 产品时间价格表接口(productPriceList):提供产品的价格和可用时间信息,支持按日期查询价格。 - 单个产品时间价格表接口(getProductPrice):获取指定产品在特定日期的价格详情。 - 单个产品信息接口(getProductInfo):获取某一产品的详细信息,包括产品描述、政策、预订须知等。 - 查询产品上下架信息接口(getProductOnLine):查询产品的上线或下线状态,以便分销商及时更新销售策略。 3. **订单信息** - 创建订单接口(createOrder):分销商通过此接口为用户预订产品,提交订单信息。 - 修改订单状态接口(updateOrderStatus):允许分销商更新订单状态,如确认支付、取消订单等。 - 获取订单信息接口(getOrder):获取订单的详细信息,包括订单号、产品信息、客户信息等。 - 重发二维码短信接口(resendCode):当用户需要重新接收二维码短信时,通过此接口发送。 - 退费接口(refund):处理用户的退款请求,实现订单退款操作。 - 创建订单验证接口(validateOrder):在创建订单前进行验证,确保订单信息的正确性。 4. **信息推送** - 产品类信息推送(pushProduct):驴妈妈会主动推送产品更新、促销等信息给分销商。 - 订单类信息推送(pushOrder):订单状态改变(如支付成功、取消订单)时,系统自动推送通知。 - 产品下线信息推送(pushOffLineProduct):产品下线时,通知分销商及时调整展示和销售。 5. **消息结构** - 请求消息报文说明:定义了接口调用时的请求格式。 - 响应消息报文说明:说明了接口返回数据的结构和含义。 - 错误代码说明表:列出可能出现的错误代码及对应的解决方案。 6. **常见问题解答** - 包含退款接口使用、信息推送方式、测试环境问题、无效IP访问、查询结果为空、重发短信异常、支付后订单取消等问题的解答,以及对BASE64编码和提前预订小时数的解释。 这套接口文档为分销商提供了完整的操作指南,确保了与驴妈妈旅游网的顺畅合作,实现了旅游产品信息的实时同步和订单管理的自动化。