Behandeln von Fehlern

API-Anfragen können zu mehreren verschiedenen Fehlerantworten führen. Das folgende Dokument behandelt die Fehlerbehebungsverfahren und enthält eine Liste der Fehlerwerte mit einer Angabe der jeweils gängigsten Behebungsmaßnahme.

Fehlerantworten

Das folgende Beispiel stellt eine gängige Fehlerantwort bei einer fehlgeschlagenen API-Anfrage dar:

{
  "error": {
    "message": "Message describing the error", 
    "type": "OAuthException", 
    "code": 190,
    "error_subcode": 460,
    "error_user_title": "A title",
    "error_user_msg": "A message",
    "fbtrace_id": "EJplcsCHuLu"
  }
}

message: Eine für Menschen lesbare Beschreibung des Fehlers.
code: Ein Fehlercode. Hierzu werden weiter unten einige häufige Werte aufgeführt, zusammen mit den jeweils gängigen Behebungsverfahren.
error_subcode: Zusätzliche Informationen zu diesem Fehler. Weiter unten werden einige gängige Werte aufgeführt.
error_user_msg: Die Meldung, die dem Nutzer angezeigt wird. Die Sprache der Meldung richtet sich nach der Ländereinstellung der API-Anfrage.
error_user_title: Der Titel des Dialogs, sofern er angezeigt wird. Die Sprache der Meldung richtet sich nach der Ländereinstellung der API-Anfrage.
fbtrace_id: Interne Support-ID. Gib bei der Meldung eines Fehlers bei einem Graph API-Aufruf die fbtrace_id an, damit wir leichter Logdaten für das Debuggen finden können. Diese ID läuft jedoch nach kurzer Zeit ab. Um dem Support-Team dabei zu helfen, dein Problem zu reproduzieren, hänge bitte eine gespeicherte Graph Explorer-Sitzung an.

Fehlercodes

Code oder Typ	Name	Vorgehensweise
OAuthException		Wenn kein Untercode vorhanden ist, sind der Login-Status oder der Zugriffsschlüssel abgelaufen, wurden entzogen oder sind auf andere Weise ungültig. Rufe einen neuen Zugriffsschlüssel ab. Wenn ein Untercode vorhanden ist, findest du darin weitere Informationen.
102	API-Sitzung	Wenn kein Untercode vorhanden ist, sind der Login-Status oder der Zugriffsschlüssel abgelaufen, wurden entzogen oder sind auf andere Weise ungültig. Rufe einen neuen Zugriffsschlüssel ab. Wenn ein Untercode vorhanden ist, findest du darin weitere Informationen.
1	API unbekannt	Möglicherweise ein vorübergehendes Problem wegen eines Ausfalls. Warte einen Moment und wiederhole den Vorgang später. Wenn der Fehler erneut auftritt, stelle sicher, dass die angefragte API vorhanden ist.
2	API-Dienst	Vorübergehendes Problem wegen eines Ausfalls. Warte einen Moment und wiederhole dann den Vorgang.
3	API-Methode	Problem mit Funktionen oder Berechtigungen. Vergewissere dich, dass deine App über die erforderlichen Funktionen oder Berechtigungen für diesen Aufruf verfügt.
4	Zu viele API-Aufrufe	Vorübergehendes Problem wegen Throttling. Warte einen Moment und wiederhole dann den Vorgang oder prüfe die Anzahl deiner API-Anfragen.
17	Zu viele API-Nutzeraufrufe	Vorübergehendes Problem wegen Throttling. Warte einen Moment und wiederhole dann den Vorgang oder prüfe die Anzahl deiner API-Anfragen.
10	API-Berechtigung abgelehnt	Die Berechtigung wurde entweder entzogen oder nicht erteilt. Hole die fehlenden Berechtigungen ein.
190	Zugriffsschlüssel ist abgelaufen	Rufe einen neuen Zugriffsschlüssel ab.
200-299	API-Berechtigung (mehrere Werte je nach Berechtigung)	Die Berechtigung wurde entweder entzogen oder nicht erteilt. Hole die fehlenden Berechtigungen ein.
341	App-Limit erreicht	Vorübergehendes Problem wegen eines Ausfalls oder wegen Throttling. Warte einen Moment und wiederhole dann den Vorgang oder prüfe die Anzahl deiner API-Anfragen.
368	Aufgrund von Richtlinienverstößen vorübergehend gesperrt	Warte einen Moment und wiederhole dann den Vorgang.
506	Doppelter Beitrag	Identische Beiträge können nicht direkt nacheinander veröffentlicht werden. Ändere den Inhalt des Beitrags und versuche es erneut.
1609005	Fehler beim Posten des Links	Beim Auslesen von Daten aus dem angegebenen Link ist ein Problem aufgetreten. Prüfe die URL und versuche es erneut.

Untercodes für Authentifizierungsfehler

Code	Name	Vorgehensweise
458	App nicht installiert	Der Nutzer hat sich nicht bei deiner App angemeldet. Authentifiziere den Nutzer erneut.
459	Nutzer bei Checkpoint abgefangen	Der Nutzer muss sich bei https://www.facebook.com oder https://m.facebook.com anmelden, um ein Problem zu beheben.
460	Passwort geändert	Wenn die Person sich bei iOS 6 und höher über den betriebssystemintegrierten Ablauf angemeldet hat, leite sie zu den Betriebssystemeinstellungen für Facebook auf dem Gerät, um ihr Passwort zu aktualisieren. Andernfalls muss sie sich erneut bei der App anmelden.
463	Abgelaufen	Login-Status oder Zugriffsschlüssel ist abgelaufen, wurde entzogen oder ist ungültig. Rufe neue Zugriffsschlüssel ab.
464	Nicht bestätigter Nutzer	Derdie Nutzerin muss sich bei https://www.facebook.com oder https://m.facebook.com anmelden, um ein Problem zu beheben.
467	Ungültiger Zugriffsschlüssel	Zugriffsschlüssel ist abgelaufen, wurde entzogen oder ist ungültig. Rufe neue Zugriffsschlüssel ab.
492	Ungültige Sitzung	Der mit dem Seiten-Zugriffsschlüssel verknüpfte Benutzer hat keine entsprechende Rolle auf der Seite.

Fehlercodes für Durchsatzratenbegrenzung

Weitere Informationen zu Fehlercodes für Durchsatzratenbegrenzung findest du im Leitfaden zu Graph API-Durchsatzratenbegrenzungen.