管理API对接文档

最近更新时间：

文档地址

说明

开放平台文档地址：https://opendocs.xiaojukeji.com/version2024

历史版本：https://open.es.xiaojukeji.com/doc/erpapi/member/list.html，历史版本24年起不再更新。


应用创建

入口：滴滴企业版 -> 开放平台首页https://open.es.xiaojukeji.com/ -> 管理中心https://open.es.xiaojukeji.com/openManage/apps

人员权限 ：仅限企业的【初始管理员】 访问（应用管理员功能规划中）

应用配置：应用配置方法参见开发者后台介绍。

注意

  1. 管理API仅提供正式环境账号。

  2. 应用初次创建后，需要点击【提交审核】按钮，等待应用上线后方可调用接口。

    审批流程：发起申请 → 业务审批 → 生态业务方审批（仅生态应用） → SSC 处理 → 审批结束并上线。

    如果遇到审批状态超过2个工作日未改变，可联系滴滴侧对接人或流程管理员谢朱莉（xiezhuli@didiglobal.com）进行处理。

  3. 应用修改后，需要点击【发布】按钮，本次修改才会生效。


接入步骤

应用上线后，使用client_id、client_secret等信息调用授权认证接口，获取access_token，用于其他接口的调用。

access_token缓存方案

说明

除了授权接口之外，所有接口都需要access_token，access_token的获取方式见授权认证;

access_token有效期为30分钟，有效期内可以使用token 调用所有接口。

建议将返回的授权信息缓存30分钟（缓存过期或调用服务时返回401=>access_token不合法或已过期,再重新申请授权）。

不建议每次调用接口申请一次授权。


接口限流

说明

目前对外接口均有限流限制：限流说明


接口域名

说明

生产环境：https://api.es.xiaojukeji.com


测试工具

签名验证工具，用于验证接口报19999签名验证失败的工具

返回值解析工具，如返回值进行了Unicode编码{"errno":51102,"errmsg":"\u4e0d\u6ee1\u8db3\u5f00\u7968\u8981\u6c42","data":null}

时间戳计算工具，用于计算当前时间戳和通过时间戳反解出年月日格式的时间

县市级城市查询工具，用于确认一个城市是否为地级市

postman脚本使用，用于验证参数正确



问题反馈方式

权限问题

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

接口调用出错问题

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


反馈信息格式

注意

问题描述(必填)

request_id(必填)

返回值(必填)

请求时间

请求url


基本要求

  1. 请接入方务必在日志中记录调用接口的请求参数、返回值，尤其是返回值中的request_id,方便问题排查；
  2. 请接入方在调用接口时严格遵守接口规范，包括请求方式(如GET或POST)、请求格式(如JSON)、请求参数格式(如JSON串或object对象或数组)等。
  3. 为提升传输安全性，滴滴企业版将在2023年6月进行OpenAPI的 TLS 版本升级变更操作，升级后 TLS 1.0及 1.1 版本请求将无法连接，仅支持 TLS1.2 及以上版本的客户端发起请求；新接入客户请确保TLS版本为1.2及以上。