接入须知

优质
小牛编辑
140浏览
2023-12-01

当前版本v1.0,只支持单次用车,预约单只能预约3天以内出发的订单。

接入前准备

接入方需要提供以下数据:
1. 接入方的基本信息,公司名称,产品域名,公司资质.
2. 公司调用提供方接口的服务器ip
3. 接入方提供支付成功回调url地址

服务方需要提供以下数据:

名称类型必选描述
client_idstringyes申请应用时分配的AppKey
client_secretstringyes申请应用时分配的AppSecret
sign_keystringyes申请应用时签名key

接入必须项

  1. 参照文档完成测试环境下的,下单,预估价格,取消订单,重叫订单,订单回调,等关键动作。
  2. 目前poi只支持soso地图。 可以通过地址联想接口获取地点的poi。
  3. 请妥善保管服务方提供的关键参数,避免泄露造成的损失!

接入流程

  1. 请求/v1/Auth/authorize获取access_token。
  2. 请求/v1/common/Cities/getAll 获取全量开通城市列表接口,检查当前城市是否开通打车服务。(建议将全量数据存到本地做成数据字典,定期更新即可,不要每次发单都调用此接口)
  3. 请求/v1/common/Address/getAddress 获取出发地和目的地。
  4. 请求/v1/common/Cities/getPrice 获取当前城市计价规则并获取车型(舒适,豪华...)。
  5. 请求/v1/order/Create/orderId 接口获取订单id
  6. 请求/v1/order/Create/request 携带订单id,出发地,时间,套餐等数据请求下单。
  7. 请求/v1/order/Detail/getOrderDetail 获取行程中订单状态
  8. 行程结束后,正常支付订单会通过回调接口通知支付状态。