接入须知
优质
小牛编辑
140浏览
2023-12-01
当前版本v1.0,只支持单次用车,预约单只能预约3天以内出发的订单。
接入前准备
接入方需要提供以下数据:
1. 接入方的基本信息,公司名称,产品域名,公司资质.
2. 公司调用提供方接口的服务器ip
3. 接入方提供支付成功回调url地址
服务方需要提供以下数据:
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
client_id | string | yes | 申请应用时分配的AppKey |
client_secret | string | yes | 申请应用时分配的AppSecret |
sign_key | string | yes | 申请应用时签名key |
接入必须项
- 参照文档完成测试环境下的,下单,预估价格,取消订单,重叫订单,订单回调,等关键动作。
- 目前poi只支持soso地图。 可以通过地址联想接口获取地点的poi。
- 请妥善保管服务方提供的关键参数,避免泄露造成的损失!
接入流程
- 请求/v1/Auth/authorize获取access_token。
- 请求/v1/common/Cities/getAll 获取全量开通城市列表接口,检查当前城市是否开通打车服务。(建议将全量数据存到本地做成数据字典,定期更新即可,不要每次发单都调用此接口)
- 请求/v1/common/Address/getAddress 获取出发地和目的地。
- 请求/v1/common/Cities/getPrice 获取当前城市计价规则并获取车型(舒适,豪华...)。
- 请求/v1/order/Create/orderId 接口获取订单id
- 请求/v1/order/Create/request 携带订单id,出发地,时间,套餐等数据请求下单。
- 请求/v1/order/Detail/getOrderDetail 获取行程中订单状态
- 行程结束后,正常支付订单会通过回调接口通知支付状态。