接入前必读

接入须知

接入用车API服务前，需要了解产品说明、安全产品说明、错误定义、订单状态定义、订单状态同步服务等知识，以便完成接下来的接入操作。点击了解更多须知

接入步骤

一企业注册

应用账号申请

接入方在调用我们接口前需要获取账号信息包含(client_id、client_secret、phone、company_id等)，这些信息可在我们官网创建应用后获得。创建正式或者测试应用的步骤请参照接入指南。

注意: 创建的应用需要等待3个工作日完成审核，完成审核之后方可调用接口，请耐心等待。

授权认证

申请到账号后，我们用账号中的client_id、client_secret等信息调用第一个接口授权认证，通过该接口的返回值access_token，我们才可以调用其他接口。

access_token缓存方案

除了授权接口之外，我们所有接口都需要access_token这个参数，该接口返回的access_token有效期为30分钟，在未过期之前接入方可以使用这个token
调用所有接口，所以建议将返回的授权信息缓存30分钟（缓存过期或调用服务时返回401=>access_token不合法或已过期,再重新申请授权），不要每次调用接口都申请一次授权。

二开发测试

测试前准备

测试前需完成以下几点：

企业注册
创建测试应用并审核通过
实现签名算法
调用授权认证接口
调用获取城市全量列表接口
1. 城市全量列表建议缓存在本地，一天更新一次即可
调用获取城市计价规则接口
1. 城市计价规则列表建议缓存在本地，一天更新一次即可

场景测试

测试司机接单：为了保证正式应用的服务可用性，开发者需要完成一系列的场景测试。
如：下单成功并结束行程完成支付

调用价格预估接口
调用获取请求id接口，获得订单id
调用订单请求接口
使用司机测试工具输入order_id后依次点击抢单、司机到达、开始计费、到达目的地
Open API回调接入方
接入方回调返回errno=0
调用获取订单详情接口查看订单状态
1. 订单接口访问增加频率限制：司机计费前（status<500）访问限制在 10秒/次。司机计费后（status>=500）访问限制在 300秒/次。如果超频：返回 errno: 36003
使用司机测试工具点击结束订单，发起支付
调用确认支付接口
完成支付

更多场景测试步骤见测试流程。

问题反馈方式

权限问题

如开通账号，申请测试应用，接口调用权限等，请联系对接的滴滴商务同学给您们开通相应的接口使用权限。

接口调用出错问题

首先查询常见错误解决方案文档尝试解决问题；
如果文档中没有解决方案，请在对接群咨询我们的销售同学；
如果销售同学无法解决，请按照以下模板提供相应的信息咨询我们的客服同学.

问题描述(必填)
request_id(必填)
返回值(必填)
请求时间
请求url

接入必知问题

1.接口是否区分大小写？

区分，请一切请求和参数都严格按照接口文档来，不要修改大小写

2.测试帐号提示余额不足怎么办？

先结束未结束的订单，多发小额订单 2.找商务同学给测试帐号充值

3.调用取消接口后返回成功，但为什么订单未真正取消?

请客户仔细看看取消订单文档cost字段的定义，见文档：取消接口

4.为什么我的订单没有自动支付？

无附加费的订单会48小时自动支付，有附加费或实际支付金额大于预估价的三倍的订单需要手动确认支付
有两种手动确认支付方式，完成其一即可： 1 用户确认支付，2 调用用车API的feeconfirm接口

更多问题见Q&A平台。

测试工具

测试司机接单工具，模拟司机接单工具,用于测试不同的用车流程；
签名验证工具，用于验证接口报19999签名验证失败的工具； 返回值解析工具，如返回值进行了Unicode编码{"errno":51102,"errmsg":"\u4e0d\u6ee1\u8db3\u5f00\u7968\u8981\u6c42","data":null}；
PHP版 或者 JAVA版，SDK工具包, 开发者可通过此SDK快速测试开发；
更多测试开发工具请点击更多。

基本要求

请接入方务必在日志中记录调用接口的请求参数、返回值，尤其是返回值中的request_id,方便问题排查；
请接入方在调用接口时严格遵守接口规范，包括请求方式(如GET或POST)、请求格式(如JSON)、请求参数格式(如JSON串或object对象或数组)等

三上线使用

应用开发测试完成后，即可提交审核，提交审核后，请联系相关商务经理审核您的应用。

接入前必读