Fehler

Die API gibt für alle Vorgänge den standardmäßigen HTTP-Erfolgs- oder Fehlerstatuscode zurück. Bei Fehlern enthält die Antwort den entsprechenden Fehlercode, eine Kurznachricht, die die Fehlerursache beschreibt, und optional zusätzliche Felder, die Informationen zu diesem Fehler enthalten.

Statuscodes

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.

Fehlercodes

invalid-body

Die API konnte den Hauptteil Ihrer Anforderung nicht verarbeiten. Stellen Sie sicher, dass der Anforderungshauptteil ein gültiger JSON ist.

invalid-parameter

Mindestens ein Parameter in Ihrem Anforderungshauptteil hat die Validierungsprüfungen nicht bestanden. Diese Antwort enthält ein params Attribut mit detaillierteren params Parametern.

unconfigured

Ihre Organisation verfügt nicht über die Konfiguration, die für die API erforderlich ist, um diese Anforderung abzuschließen. Die Nachricht enthält Details dazu, welche Konfiguration fehlt.

missing-scope

Ihre Organisation, Ihr Schlüssel oder Ihr aktueller Benutzer verfügt nicht über die erforderlichen Berechtigungsbereiche, um diese Anforderung auszuführen.

limit-exceeded

Die Anforderung konnte nicht abgeschlossen werden, da sie ein Limit verletzen würde, das Ihrer Organisation, Ihrem Schlüssel oder Ihrem aktuellen Benutzer auferlegt wurde. Beispielsweise erhält ein Benutzer, der nur auf zwei iCloud-Konten pro Monat zugreifen darf, diese Fehlermeldung, wenn er versucht, auf ein drittes Konto zuzugreifen.

session-expired

Die Sitzung, die Sie für diese Anforderung verwenden möchten, wurde von der API als abgelaufen markiert. Sie müssen eine neue, gültige Sitzung erstellen, bevor Sie fortfahren können.

invalid-credentials

Die angegebenen Anmeldeinformationen wurden vom externen Dienst abgelehnt. Entweder ist die Quelle nicht vorhanden (dh ungültiger Benutzername) oder die Nutzdaten der Anmeldeinformationen sind falsch (z. B. ein falsches Passwort).

source-locked

Die Quelle wurde vom externen Dienst gesperrt und kann von der API erst aufgerufen werden, wenn der Benutzer sie entsperrt hat. Die API-Nachricht enthält Anweisungen dazu, wie dies für den jeweiligen Dienst durchgeführt wird.

code-required

Die Quelle, für die Sie eine Sitzung erstellen möchten, ist für die Multi-Faktor-Authentifizierung (MFA) aktiviert. Die API hat den MFA-Prozess ausgelöst, und Sie müssen den während dieses Prozesses angezeigten Code bei Ihrem nächsten Sitzungserstellungsversuch angeben.

Weitere Informationen zum Ablauf der Sitzungserstellung finden Sie in der Dienstreferenz für den Dienst, auf den Sie zugreifen möchten.

code-rate-limited

Der Benutzer hat zu oft versucht, eine Sitzung mit einem ungültigen Code zu erstellen, und wurde vom Dienst auf die Rate beschränkt. Wir empfehlen dem Benutzer, mindestens eine Stunde zu warten, bevor er es erneut versucht.

choice-required

Bei der Quelle, auf die Sie zugreifen möchten, ist die 2-Schritt-Überprüfung (2SV) aktiviert, eine Teilmenge der Multi-Faktor-Authentifizierung (MFA). Als Teil dieser Antwort stellt die API eine Liste der Geräte bereit, für die der 2SV-Prozess ausgelöst werden kann. Dieses Gerät erhält den 2SV-Code, der für den nächsten Schritt im Prozess benötigt wird.

Weitere Informationen zum Ablauf der Sitzungserstellung finden Sie in der Dienstreferenz für den Dienst, auf den Sie zugreifen möchten.

task-error

Ein allgemeiner Aufgabenfehler ist aufgetreten. Durch erneutes Versuchen der Umfrage oder Aufgabe wird das Problem möglicherweise behoben. Bitte wenden Sie sich an den Support, wenn das Problem weiterhin besteht.

iCloud-Dienstfehlercodes

icloud-terms-not-accepted

Der Benutzer hat die neuesten iCloud-Nutzungsbedingungen nicht akzeptiert. Sie können die Bedingungen akzeptieren, indem Sie sich mit ihrem Konto auf einem iOS- oder MacOS-Gerät im App Store anmelden oder auf iCloud.com gehen .

icloud-account-not-verified

Die mit dem iCloud-Konto verknüpfte primäre E-Mail-Adresse wurde noch nicht überprüft. Der Benutzer muss den E-Mail-Überprüfungsprozess abschließen, um das Konto zu aktivieren. Der Überprüfungsprozess kann durch Anmelden bei appleid.apple.com verwaltet werden .

icloud-service-not-activated

Der zum Abschließen des Vorgangs erforderliche iCloud-Dienst wurde auf dem verwendeten iCloud-Konto nicht aktiviert. Wenn der Benutzer beispielsweise iCloud Photo Library für das Konto nicht aktiviert hat, wird dieser Fehler beim Versuch, icpl.photos abzurufen, icpl.photos .

Stellen Sie sicher, dass der Benutzer die zugehörigen Einstellungen eines Dienstes umgeschaltet hat, um sicherzustellen, dass er aktiviert ist.

icloud-service-outage

Der Vorgang konnte aufgrund eines iCloud-Ausfalls nicht abgeschlossen werden. Diese sind sehr selten und in der Regel vorübergehend - ein erneuter Versuch innerhalb weniger Minuten sollte erfolgreich sein. Wenn das Problem weiterhin besteht, suchen Sie auf der iCloud-Statusseite und der API- Statusseite nach weiteren Informationen und wenden Sie sich an den Support.