API precedenti
Attenzione: le seguenti API sono deprecate e sono mantenute attive per mantenere funzionanti alcune vecchie app esistenti. Pertanto non saranno rilasciate nuove chiavi di accesso. La seguente documentazione è mantenuta per ragioni storiche.
API versione 2
È possibile interfacciare Urly con altri servizi o applicazioni, utilizzando il seguente set di API. È necessario possedere una chiave API segreta.
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:
| Errore | Descrizione |
|---|---|
| _NO_API_KEY | Non è stata specificata la propria API segreta con apik=CHIAVE. |
| _BANNED_API_KEY | La chiave segreta utilizzata non esiste o è stata bloccata da Urly. |
| _NO_API_VERSION | Non è stata specificata la versione API con apiv=2. |
| _UPDATE_API | La versione API richiesta non è più disponibile. Aggiornare l'applicazione. |
| _NO_URL | Non è stato specificato un URL da accorciare. |
| _INVALID_URL | L'URL specificato non è un indirizzo web corretto. |
| _ANTIFLOOD_WAIT | L'utente deve attendere qualche secondo prima di poter creare un altro link. |
| _INVALID_IP | Il server di Urly non riesce a leggere l'indirizzo IP del client. Per motivi di sicurezza, il link non può essere accorciato. |
| _INTERNAL_ERROR | Errore generico del server. Impossibile creare il link. |
API versione 1
La versione 1 dell'API è stata deprecata ma è ancora utilizzabile. È equivalente alla versione 2,
con la differenza che viene restituito soltanto l'ID del link accorciato (es. 2t5k), anziché
l'intero link breve (es. https://urly.it/2t5k).