错误

更新
Cover image for: 错误

API返回所有操作的标准HTTP成功或错误状态代码。对于错误,响应将包括相应的错误代码,描述错误原因的短消息,以及可选地传达特定于该错误的信息的附加字段。

状态代码

code name description
200 OK The request was processed succesfully.
201 Created The request was processed successfully, and a new resource instance was created.
400 Bad Request The API was unable to process the request as it was malformed in some way.
401 Unauthorized The API was unable to find valid credentials in the request.
403 Forbidden The credentials provided do not have sufficient permissions to perform the request.
404 Not Found The requested resources cannot be found.
429 Too Many Requests The request has not been processed as a rate limit has been reached.
5xx Internal Server Error An unexpected error occurred while processing the event.

错误代码

invalid-body

API无法处理您的请求正文。确保请求正文是有效的JSON。

invalid-parameter

请求正文中的一个或多个参数未通过验证检查。此响应将包含一个params属性,其中包含有关违规参数的更多详细信息。

unconfigured

您的组织没有API完成此请求所需的配置。该消息将包含缺少配置的详细信息。

missing-scope

您的组织,密钥或当前用户没有执行此请求所需的权限范围。

limit-exceeded

该请求无法完成,因为它违反了对您的组织,主要用户或当前用户施加的限制。例如,如果每月只能访问两个iCloud帐户的用户尝试访问第三个帐户,则会收到此错误。

session-expired

您尝试用于此请求的会话已被API标记为已过期。您必须先创建一个新的有效会话,然后再继续。

invalid-credentials

提供的凭据被外部服务拒绝。源不存在(即无效的用户名)或凭证有效负载错误(例如密码错误)。

source-locked

源已被外部服务锁定,并且在用户解锁之前API无法访问。 API消息将提供有关如何为相关服务执行此操作的说明。

code-required

您尝试创建会话的源具有多因素身份验证(MFA)启用。 API将触发MFA流程,您必须在下一次会话创建尝试时提供此过程中显示的代码。

有关会话创建流程的更多详细信息,请参阅您尝试访问的服务的服务参考。

code-rate-limited

用户经常尝试使用无效代码创建会话,并且受到服务的速率限制。我们建议用户至少等待一个小时,然后重试。

choice-required

您正在尝试访问的源是启用了两步验证(2SV),这是多因素身份验证(MFA)的子集。作为此响应的一部分,API将提供可触发2SV进程的设备列表;该设备将接收2SV代码,该代码将用于该过程的下一步骤。

有关会话创建流程的更多详细信息,请参阅您尝试访问的服务的服务参考。

task-error

发生一般任务错误。重试轮询或任务可能会解决问题。如果问题仍然存在,请联系支持。

iCloud服务错误代码

icloud-terms-not-accepted

用户尚未接受最新的iCloud服务条款。他们可以通过使用其帐户在iOS或macOS设备上登录App Store或访问iCloud.com接受条款

icloud-account-not-verified

与iCloud帐户关联的主要电子邮件地址尚未验证。用户必须完成电子邮件验证过程才能激活帐户。可以通过登录appleid.apple.com来管理验证过程。

icloud-service-not-activated

完成操作所需的iCloud服务尚未在使用的iCloud帐户上激活。例如,如果用户尚未在帐户上启用iCloud照片库,则在尝试检索icpl.photos时将引发此错误。

确保用户已切换服务的关联设置以确保已激活它。

icloud-service-outage

由于iCloud中断,无法完成该操作。这些非常罕见,通常是短暂的-几分钟后重试应该可以成功。但是,如果问题仍然存在,请在iCloud状态页API状态页上查找更多信息,然后与支持人员联系。

我们能帮你什么吗?

我们的支持团队在这里提供帮助!

我们的办公时间是格林威治标准时间周一至周五上午9点至下午5点。 时间目前是 10:32 PM的 GMT。

我们力争在一个工作日内答复所有垂询。

我们的支持团队非常棒

我们可以改进这篇文章吗?

我们喜欢听取用户的意见:为什么不给我们发电子邮件,发表评论或发推文 @reincubate?

© 2008 - 2023 Reincubate Ltd. 保留所有权利。 在英格兰和威尔士注册 #5189175, VAT GB151788978. Reincubate®和Camo®是注册商标。 隐私政策 & 条款. 在伦敦建立了爱情。