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