接入前必读
账号申请
接入方在调用我们接口需要client_id、client_secret、phone、company_id等一些通用的接入方账号信息,这些信息可在我们官网创建正式应用后获得。 创建正式应用的步骤请参照申请测试应用步骤。
注意:
- 管理API没有测试应用的账号!请您一定要创建正式应用以获取账号信息!切记!
- 创建的应用需要等待3个工作日完成审核,完成审核之后方可调用接口,请耐心等待。
接入步骤
申请到账号后,我们用账号中的client_id、client_secret等信息调用的第一个接口授权认证,通过该接口的返回值access_token,我们才可以调用其他接口。
access_token缓存方案
除了授权接口之外,我们所有接口都需要access_token这个参数,access_token的获取方式见[授权认证接口](../oauth/auth.md);该接口返回的access_token有效期为30分钟,在未过期之前接入方可以使用这个token
调用所有接口,所以建议将返回的授权信息缓存30分钟(缓存过期或调用服务时返回401=>access_token不合法或已过期,再重新申请授权),不要每次调用接口都申请一次授权。
测试工具
签名验证工具,用于验证接口报19999签名验证失败的工具
返回值解析工具,如返回值进行了Unicode编码{"errno":51102,"errmsg":"\u4e0d\u6ee1\u8db3\u5f00\u7968\u8981\u6c42","data":null}
时间戳计算工具,用于计算当前时间戳和通过时间戳反解出年月日格式的时间
县市级城市查询工具,用于确认一个城市是否为地级市
问题反馈方式
权限问题
如开通账号,申请测试应用,接口调用权限等,请联系对接的滴滴商务同学
给您们开通相应的接口使用权限
接口调用出错问题
- 首先查询常见错误解决方案文档尝试解决问题;
- 如果文档中没有解决方案,请在对接群咨询我们的销售同学;
- 如果销售同学无法解决,请按照以下模板提供相应的信息咨询我们的客服同学
问题描述(必填) request_id(必填) 返回值(必填) 请求时间 请求url
基本要求
- 请接入方务必在日志中记录调用接口的请求参数、返回值,尤其是返回值中的request_id,方便问题排查;
- 请接入方在调用接口时严格遵守接口规范,包括请求方式(如GET或POST)、请求格式(如JSON)、请求参数格式(如JSON串或object对象或数组)等。
- 为提升传输安全性,滴滴企业版将在2023年6月进行OpenAPI的 TLS 版本升级变更操作,升级后 TLS 1.0及 1.1 版本请求将无法连接,仅支持 TLS1.2 及以上版本的客户端发起请求;新接入客户请确保TLS版本为1.2及以上。