Error Handling

Le API flu.lu utilizzano codici di stato HTTP standard e messaggi di errore applicativi per indicare il successo o il fallimento di una richiesta.

Struttura delle risposte di errore applicativo

Quando si verifica un errore specifico dell'applicazione, il corpo della risposta conterrà dettagli utili per capire il problema:

{
  "error_code": "codice_univoco",
  "message": "Messaggio descrittivo dell'errore"
}

Esempi di errori applicativi comuni

Parametro mancante

{
  "error_code": "missing_parameter",
  "message": "Il parametro 'url' è obbligatorio e manca nella richiesta."
}

Shortcode non valido

{
  "error_code": "invalid_shortcode",
  "message": "Lo shortcode specificato non è valido o non esiste."
}

Link già esistente

{
  "error_code": "link_already_exists",
  "message": "Il link che hai provato a creare esiste già."
}

Quota massima raggiunta

{
  "error_code": "quota_reached",
  "message": "Hai raggiunto il numero massimo di link ridotti consentiti dal tuo piano."
}

Errore interno generico

{
  "error_code": "internal_error",
  "message": "Si è verificato un errore interno, riprova più tardi o contatta il supporto."
}