Gestione degli errori

Le richieste effettuate alle nostre API possono determinare diverse risposte di errore. Il seguente documento descrive le tattiche di recupero e fornisce una lista di valori di errore con una mappa delle tattiche di recupero più comuni da utilizzare.

Risposte di errore

La seguente risposta rappresenta una risposta di errore comunemente restituita quando una richiesta API non è riuscita:

{
  "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: una descrizione leggibile dell'errore.
code: un codice di errore. I valori comuni sono elencati di seguito, insieme alle tattiche di recupero più comuni.
error_subcode: informazioni aggiuntive sull'errore. I valori comuni sono elencati di seguito.
error_user_msg: il messaggio da presentare all'utente. La lingua del messaggio si basa sulla lingua della richiesta API.
error_user_title: il titolo della finestra di dialogo, se visualizzata. La lingua del messaggio si basa sulla lingua della richiesta API.
fbtrace_id: identificativo interno per l'assistenza. Se segnali un bug relativo a una chiamata API Graph, includi fbtrace_id per aiutarci a individuare i dati del registro per il debug. Tuttavia, questo ID scadrà a breve. Per aiutare il team di assistenza a riprodurre il tuo problema, allega una sessione di Graph Explorer salvata.

Codici di errore

Codice o tipo	Nome	Cosa fare
OAuthException		Se non è presente alcun sottocodice, lo stato di accesso o il token d'accesso è scaduto, è stato revocato o non è valido. Ottieni un nuovo token d'accesso. Se è presente, consulta il sottocodice.
102	API Session	Se non è presente alcun sottocodice, lo stato di accesso o il token d'accesso è scaduto, è stato revocato o non è valido. Ottieni un nuovo token d'accesso. Se è presente, consulta il sottocodice.
1	API Unknown	Potrebbe essere un problema temporaneo dovuto a inattività. Attendi e riprova a eseguire l'operazione. Se si verifica nuovamente, verifica che la richiesta venga effettuata a un'API esistente.
2	API Service	Problema temporaneo dovuto a inattività. Attendi e riprova a eseguire l'operazione.
3	API Method	Problema di funzionalità o autorizzazioni. Assicurati che la tua app disponga della funzionalità o delle autorizzazioni necessarie per effettuare questa chiamata.
4	API Too Many Calls	Problema temporaneo dovuto a throttling. Attendi e riprova a eseguire l'operazione; in alternativa, esamina il volume di richieste all'API.
17	API User Too Many Calls	Problema temporaneo dovuto a throttling. Attendi e riprova a eseguire l'operazione; in alternativa, esamina il volume di richieste all'API.
10	API Permission Denied	L'autorizzazione non è stata concessa o è stata rimossa. Gestisci le autorizzazioni mancanti.
190	Access token has expired	Ottieni un nuovo token d'accesso.
200-299	API Permission (più valori a seconda dell'autorizzazione)	L'autorizzazione non è stata concessa o è stata rimossa. Gestisci le autorizzazioni mancanti.
341	Application limit reached	Problema temporaneo dovuto a inattività o throttling. Attendi e riprova a eseguire l'operazione; in alternativa, esamina il volume di richieste all'API.
368	Temporarily blocked for policies violations	Attendi e riprova a eseguire l'operazione.
506	Duplicate Post	Non puoi pubblicare post duplicati consecutivamente. Modifica i contenuti del post e riprova.
1609005	Error Posting Link	Si è verificato un problema durante l'estrazione dei dati dal link fornito. Verifica l'URL e prova a ripetere l'operazione.

Sottocodici degli errori di autenticazione

Codice	Nome	Cosa fare
458	App Not Installed	L'utente non ha effettuato l'accesso all'app. Effettua la riautenticazione dell'utente.
459	User Checkpointed	L'utente deve effettuare l'accesso all'indirizzo https://www.facebook.com o https://m.facebook.com per risolvere un problema.
460	Password Changed	Su iOS 6 e versioni successive, se l'utente ha effettuato l'accesso utilizzando il flusso integrato nel sistema operativo, indirizzalo alle impostazioni del sistema operativo di Facebook sul dispositivo per aggiornare la password. In caso contrario, deve accedere nuovamente all'app.
463	Expired	Lo stato di accesso o il token d'accesso è scaduto, è stato revocato o non è valido. Gestisci i token d'accesso scaduti.
464	Unconfirmed User	L'utente deve effettuare l'accesso all'indirizzo https://www.facebook.com o https://m.facebook.com per risolvere un problema.
467	Invalid Access Token	Il token d'accesso è scaduto, è stato revocato o non è valido. Gestisci i token d'accesso scaduti.
492	Invalid Session	L'utente associato al token d'accesso della Pagina non ha un ruolo appropriato sulla Pagina.

Codici di errore di rate limiting

Visita la guida di rate limit dell'API Graph per maggiori informazioni sui codici di errore di rate limiting.