API 问题排查
优质
小牛编辑
121浏览
2023-12-01
API问题排查
为了方便开发者快速排查问题，开放平台提供了错误代码建议方案一览表，方便开发者快速解决问题。
错误代码及建议方案一览表
auth验证错误
| 错误代码 | 错误描述 | 解决方案 |
|---|---|---|
| 400 | 请求参数相关错误（client_id/grant_type等错误） | 调用授权认证接口时，请确认您的参数正确，包括参数类型、参数内容、必要参数是否完整。详情见文档授权认证 |
| 401 | access_token不合法或已过期等 | access_token缓存时间为半小时，过期请重新申请调用访问权限 |
| 402 | 未传当前用户手机号或手机号不合法 | 情况一，请查看是否传手机号情况二，请确定您传参的手机号是超级管理员账号，即应用详情中授权信息中的phone |
| 403 | 您无权访问该服务 | 应用没有权限调用接口，可在开放平台管理中心提交应用申请或查看您申请的权限是否正确 |
| 404 | 您没有访问该接口的权限 | 应用没有权限调用接口，可在开放平台管理中心提交应用申请或查看您申请的权限是否正确，暂未启用此错误码 |
| 405 | 请用POST方式请求access_token | 请求相应接口时，请查看相关文档的要求用GET或POST方式提交 |
| 406 | 该用户不存在，请管理员添加后再使用 | 请确定您传参的手机号是超级管理员，具体流程如下： |
| 407 | sign签名验证失败，无权访问该接口 | 情况一，签名错误。请使用我们提供的签名验证工具验证。或直接使用我们提供的签名验证SDK进行签名验证情况二，请求时，sign复用。签名是和所有参数相关联的，任何一个参数有变动，签名都要重新计算的，不能复用原来的sign |
| 410 | client_id不一致 | 请查看请求的client_id，是否和申请应用时提供的client_id一致 |
| 412 | client_id和client_secret为必填项 | 请根据要求添加client_id和client_secret |
| 500 | access_token生成失败，请稍后重试 | 请使用date命令检查确定您的服务器时间是否为最新时间，时间戳和服务端时间差距不能超过1分钟。 |
系统级错误
| 错误代码 | 错误描述 | 解决方案 |
|---|---|---|
| 10001 | 请求超时 | 请检查确定您的服务器时间是否为最新时间，时间戳和服务端时间差距不能超过1分钟。（date命令检查时间） |
| 10002 | ip验证失败，服务器IP为申请应用时输入的IP地址 | 服务器IP为申请应用时输入的IP地址，动态IP请联系自己公司的相关人员确定全部IP或IP段。 |
| 10003 | 参数错误 | 需要传入的是数字类型的，却传入了字符类型的参数参数内容错误，请仔细核对文档。缺少必要参数，API文档中设置为必选的参数是必传的，请仔细核对接口文档 |
| 19998 | 系统异常 | 系统报错，如果频繁出现该情况，请联系滴滴工作人员 |
| 19999 | 签名失败 | 请按照签名算法规则或使用我们提供的签名SDK工具请求授权接口，请求前可使用签名验证工具验证签名。 |
服务级错误
| 错误代码 | 错误描述 | 解决方案 |
|---|---|---|
| 20001 | 请求参数错误 | 调用订单请求接口时，请确认您的参数正确，包括参数类型、参数内容、必要参数是否完整。详情见文档订单请求 |
| 20002 | 叫车太频繁了 | passanger_phone同一时间只能发单一次，无法同时发单，请检查您的上一次订单是否关闭 |
| 20003 | 无效的订单id | 请查看请求参数中的order_id是否正确，请求查看订单流程是否正确，请求订单ID→订单请求→订单详情 |
| 20004 | 出发时间太近了，应该叫实时单 | 预约单只能预约距离出发时间至少半小时以上的用车。 |
| 20008 | 抱歉，只能叫3天以内的订单 | 预约单只能预约距离出发时间3天内的用车。 |
| 20010 | 无效订单 | 订单过期，请调用请求订单id接口，重新请求订单号。 |
| 20012 | 订单取消失败,稍后请重试 | 系统报错，如果频繁出现该情况，请联系滴滴工作人员。 |
| 20013 | 订单已进入行程中无法取消,如有问题请联系客服 | 行程中的订单乘客无法取消。 |
| 20014 | 订单当前状态不能取消，稍后重试 | 订单行程和结束后无法取消 |
| 31001 | 请求参数错误 | 调用价格预估接口时，请确认您的参数正确，包括参数类型、参数内容、必要参数是否完整。详情见文档价格预估 |
| 36001 | 请求参数错误 | 调用订单详情接口时，请确认您的参数正确，包括参数类型、参数内容、必要参数是否完整。详情见文档订单详情 |
| 36002 | 请求订单权限受限 | 发此情况下一般出现在订单ID请求的应用和叫车时的应用不同 |
| 36003 | 订单接口访问频次过高 | 订单详情接口访问具有频率限制：司机计费前（status<500）访问限制在 10秒/次。司机计费后（status>=500）访问限制在 300秒/次。 |
| 36004 | 获取订单失败 | 系统报错，如果频繁出现该情况，请联系滴滴工作人员 |
| 37001 | 请求参数错误 | 调用支付确认接口时，请确认您的参数正确，包括参数类型、参数内容、必要参数是否完整。详情见文档支付确认 |
| 37002 | 该订单权限受限 | 发此情况下一般出现在订单ID请求的应用和叫车时的应用不同 |
| 37004 | 处理失败 | 支付失败，请重试 |