Errori e limiti
Il formato delle risposte d'errore, i codici HTTP più comuni e i limiti di frequenza.
Formato
Le risposte d'errore hanno la forma standard del framework:
{ "statusCode": 400, "message": "SUBSCRIPTION_MAX", "error": "Bad Request" }Per gli errori di business message è un codice in maiuscolo, non una frase da mostrare all'utente. Per gli errori di validazione message è una lista di stringhe. Non c'è un campo code separato.
Codici HTTP
| Codice | Quando |
|---|---|
400 | dati non validi, campi non ammessi, codice di business, header organizzazione mancante |
401 | token assente o non valido (INVALID_TOKEN) |
403 | permessi insufficienti |
404 | risorsa inesistente |
422 | per esempio manca il modello dell'attestato, o una lista nell'URL è troppo lunga |
429 | troppe richieste: l'header Retry-After indica i secondi da attendere |
Il corpo delle richieste è limitato a 2 MB.
Codici di business osservati
| Codice | Significato |
|---|---|
SUBSCRIPTION_MAX | posti esauriti |
EVENT_INACTIVE | l'evento non accetta iscrizioni |
SUBSCRIPTION_INACTIVE | le iscrizioni sono chiuse |
SUBSCRIPTION_NOT_ACCEPTED | l'iscrizione non è accettata |
NOT_ATTENDED | nessuna partecipazione per l'attestato |
EXAM_INACTIVE, EXAM_PASSED, MAX_ATTEMPTS, EXAM_INVALID_REQUIREMENTS | esame non attivo, già superato, tentativi esauriti, requisiti non soddisfatti |
NOT_PASSED | esame non superato (attestato) |
INVALID_CREDENTIALS, USER_NOT_VERIFIED, USER_ALREADY_EXISTS, TOKEN_NOT_FOUND, INVALID_TOKEN | accesso e registrazione |
L'elenco non è esaustivo e i codici possono cambiare senza preavviso.
Questo articolo ti è stato utile?