Errori

L'API usa i codici di stato HTTP standard. In caso di errore il corpo della risposta ha sempre questa forma:

{
  "success": false,
  "error": "Invalid URL format"
}

Il campo error contiene un messaggio leggibile (in inglese). Controlla sempre il codice di stato HTTP prima di leggere il corpo.

Codici di stato

400

Richiesta non valida

Parametri mancanti o con formato errato (URL non valido, alias con caratteri non consentiti, data non futura, max_uses non positivo...).

401

Non autorizzato

Token mancante, non valido, disattivato o scaduto.

403

Vietato

Stai modificando o eliminando un URL creato con un altro token.

404

Non trovato

L'URL o l'endpoint richiesto non esiste.

409

Conflitto

Alias o short code già in uso.

429

Troppe richieste

Hai superato il rate limit. Riprova dopo il tempo indicato in Retry-After.

503

Servizio non disponibile

Il servizio è in manutenzione.