Usiamo cookie per personalizzare contenuti e pubblicitĂ  e analizzare il traffico. Condividiamo tali info con partner che possono aggregarle ad info che hai fornito o che loro hanno collezionato usando i loro servizi. Interagendo col sito accetti tutti i termini d'uso e privacy: leggili · Chiudi
Menu Menu
Accedi Registrati

Urly

API

API di Urly versione 2

È possibile interfacciare Urly con altri servizi o applicazioni, utilizzando il seguente set di API. È necessario possedere una chiave API segreta, per richiederla gratuitamente contattaci.

Per creare un link accorciato, richiamare il seguente URL https://urly.it/api.php?apiv=2&apik=CHIAVE&url=INDIRIZZO dove CHIAVE è la propria chiave API segreta e INDIRIZZO è l'URL originale che si desidera accorciare (il https:// all'inizio del link da accorciare non è obbligatorio).

L'output è fornito in testo semplice (text/plain) ed è costituito dall'URL del link accorciato. Ad esempio:
https://urly.it/2t5k
I codici errore sono preceduti dal simbolo underscore _ e possono essere i seguenti:

_NO_API_KEYNon è stata specificata la propria API segreta con apik=CHIAVE.
_BANNED_API_KEYLa chiave segreta utilizzata non esiste o è stata bloccata da Urly.
_NO_API_VERSIONNon è stata specificata la versione API con apiv=1.
_UPDATE_APILa versione API richiesta non è più disponibile. Aggiornare l'applicazione.
_NO_URL Non è stato specificato un URL da accorciare.
_INVALID_URLL'URL specificato non è un indirizzo web corretto.
_ANTIFLOOD_WAITL'utente deve attendere qualche secondo prima di poter creare un altro link.
_INVALID_IPIl server di Urly non riesce a leggere l'indirizzo IP del client. Per motivi di sicurezza, il link non può essere accorciato.
_INTERNAL_ERRORErrore generico del server. Impossibile creare il link.

Aggiornamenti dall'API versione 1

La versione 1 dell'API è stata deprecata ma è ancora utilizzabile. Precedentemente veniva restituito soltanto l'ID del link accorciato (es. 2t5k). Nell'API versione 2 viene invece restituito l'intero link breve (es. https://urly.it/2t5k).