常见 HTTP 错误

以下是 API 在出现异常时返回的最常见 HTTP 错误代码。

有关详细信息，请查阅每个单独 API 的文档

故障代码	描述
400 BAD REQUEST	使用无效参数或消息正文元素发出了请求，例如： - 您尝试保存用户时指定了无效引用用户的代码 - 您尝试将元素链接到不存在的层次节点
401 UNHAUTORIZED	"Authorization failure. The authorization header is invalid or missing." 在 BASIC 身份验证的情况下，如果出现以下情况则会发生： - 用户名或密码无效 - 如果为用户勾选了该选项 在 OAUTH2 身份验证的情况下： - 如果令牌的内容无法识别
403 FORBIDDEN	"Access not granted" 或 "Access not granted for function XXX"。 用户没有通过 API 执行所请求操作的适当角色。示例： - 您尝试通过 SCIM API 保存新用户，但对用户数据库只有只读访问权限 - 您尝试通过 ODATA 读取审计数据，但没有访问 Repository 的权限 通常，响应正文包含执行该操作所需的功能。 - 如果使用的 HTTP 动词是 DELETE、PATCH、POST 或 PUT，则需要读/写权限 - 如果使用的 HTTP 动词是 GET，通常只读权限就足够。
500 INTERNAL SERVER ERROR	这是需要特定支持的运行异常。 相当于应用程序内未处理的错误消息
503 SERVICE UNAVILABLE	公共 API 已在配置中被禁用。要启用它们，请参阅激活。