API常见异常和技巧处理

简介:这个文档列出了常见的API异常响应代码和技巧来处理。188bet金宝搏appADP建议开发人员审查这些异常时结合ADP api。

异常

响应代码

错误描述

异常条件

响应

如何处理

400错误请求

表明缺失或重复的参数。

一个访问令牌调用没有grant_type参数。

{
“错误”:“invalid_request”,
:“error_description缺失或重复参数”
}

确保grant_type参数设置的访问令牌。

400错误请求

显示无效grant_type

一个访问令牌的电话是无效的grant_type

{
“错误”:“unsupported_grant_type”,
“error_description”:“无效的grant_type”
}

确保正确的值被发送grant_type参数。
例如:
grant_type = client_credentials

400错误请求

表示Validationerror。

请求中的令牌丢失或无效的请求中发送令牌。

{
“错误”:“invalid_request”,
“error_description”:“验证错误”
}

确保正确的标记包含在请求。

400错误请求

表明一个无效的代码/丢失的作用。

没有找到相关联的功能、角色代码或启用请求者。

processMessages”: [{“userMessage”: {“messageTxt”:“无效的/失踪的角色代码”

在ADP产品188bet金宝搏app,分配合适的演员允许HTTP请求者。

为进一步帮助你联系ADP的代表。188bet金宝搏app

401授权错误

表明,给定客户端凭证是无效的。

客户机ID或客户机访问令牌叫秘密输入无效。

{
“错误”:“invalid_client”,
:“error_description给定客户端凭据无效”
}

验证正确的客户机ID和客户秘密被通过。

401授权错误

指定适当的客户机secure sockets layer (SSL)证书没有了。

合适的安全的SSL证书不发送。

{
“错误”:“invalid_request”,
“error_description”:“ssl证书没有提供适当的客户”
}

确保有效的SSL证书请求中发送。

403年被禁止的错误

表示订阅状态暂停。

客户端订阅数据连接器应用程序暂停。

{
“错误”:“access_denied”,
:“error_description订阅状态悬浮”
}

核实客户的订阅状态。然后,联系你的客户激活订阅。

403年被禁止的错误

表示同意并没有提供。

客户没有提供同意或已暂停同意连接器应用程序的数据。

{
“错误”:“access_denied”,
“error_description”:“同意不提供”}

要求客户提供同意您的数据连接器应用程序。
有关更多信息,请参阅您的客户端使用许可管理器来控制访问您的数据

403年被禁止的错误

显示一个invalid_scope

API请求应用程序中未被授权的范围。当你的使用者应用程序需要使用额外的API,请联系您的ADP代表每个API添加到您的应用程序范围。188bet金宝搏app

{
“error_code”:“invalid_scope”,
“error_description”:“请求的范围是不允许的
}

将API添加到您的应用程序的范围,请联系您的ADP的代表。188bet金宝搏app确保你提供以下:

  • 组织名称
  • 应用程序名称
  • api添加列表

403年被禁止的错误

调用HTTP请求没有底层ADP的正确授权的应用程序功能。188bet金宝搏app

{“messageTxt”:“不允许操作”},

执行以下操作:

  1. 验证客户的特性在应用程序中打开API试图访问数据。
  2. 验证调用HTTP请求/用户数据访问。例如,ADP劳动力现在使用188bet金宝搏app概要文件来管理数据访问的一群人。API请求者需要在适当的配置文件,配置哪些需要访问所请求的数据API。

404没有找到

表明此服务的范围是无效或未定义的。188bet金宝搏app

无效的请求中使用URI。

{
“错误”:“invalid_scope”,
“error_description”:“这项服务是无效或未定义的范围188bet金宝搏app
}

确保正确的URI是包含在请求。

503服188bet金宝搏app务不可用

未能检索同意状态。

客户同意记录是不可用的。

{
“错误”:“temporarily_unavailable”,
“error_description”:“未能检索同意地位”
}

请联系您的ADP的代表。188bet金宝搏app

503服188bet金宝搏app务不可用

指定基础设施是暂时不可用。

188bet金宝搏appADP服188bet金宝搏app务不可用。

{
“错误”:“temporarily_unavailable”,
“error_description”:“基础设施暂时不可用”
}

再试一次。
如果发生错误,请联系您的ADP的代表。188bet金宝搏app

这些常见的例外适用于所有ADP api。188bet金宝搏app请查看API文档特定于单个API异常代码和错误