错误

更新一个多星期前

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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