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 | Beschreibung |
|---|---|---|
| 200 | OK | Die Anfrage wurde erfolgreich bearbeitet. |
| 201 | Erstellt | Die Anfrage wurde erfolgreich verarbeitet und eine neue Ressourceninstanz wurde erstellt. |
| 400 | Ungültige Anforderung | Die API konnte die Anfrage nicht verarbeiten, da sie fehlerhaft war. |
| 401 | Nicht autorisiert | Die API konnte in der Anfrage keine gültigen Anmeldeinformationen finden. |
| 403 | Verboten | Die angegebenen Anmeldeinformationen verfügen nicht über ausreichende Berechtigungen zum Ausführen der Anfrage. |
| 404 | Nicht gefunden | Die angeforderten Ressourcen können nicht gefunden werden. |
| 429 | Zu viele Anfragen | Die Anfrage wurde nicht verarbeitet, da eine Ratenbegrenzung erreicht wurde. |
| 5xx | interner Serverfehler | Beim Verarbeiten des Ereignisses ist ein unerwarteter Fehler aufgetreten. |
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 aktuellen iCloud-Nutzungsbedingungen nicht akzeptiert. Er kann die Bedingungen akzeptieren, indem er sich auf einem iOS- oder macOS-Gerät mit seinem Konto beim App Store anmeldet oder iCloud.com besucht.
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-web-access-required
Der Zugriff auf iCloud-Daten im Web ist für das Konto deaktiviert. Informationen zur Aktivierung finden Sie im Support-Artikel von Apple .
icloud-adp-enabled
Für das iCloud-Konto ist der erweiterte Datenschutz aktiviert. Dies wird von der API nicht unterstützt. Informationen zum Deaktivieren finden Sie im Support-Artikel von Apple .
icloud-signin-rate-limited
Der Zugriff auf das iCloud-Konto wird von Apple begrenzt, in der Regel aufgrund zu vieler fehlgeschlagener Versuche zur Sitzungsinitialisierung. Bitte versuchen Sie es später erneut.
icloud-account-locked
Der Zugriff auf das iCloud-Konto wurde von Apple gesperrt, üblicherweise aus Sicherheitsgründen. Wenden Sie sich an den Apple-Support, um weitere Informationen zum Entsperren des Kontos zu erhalten.
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.