Vai al contenuto
andiamo.li

Per sviluppatori

Puoi accorciare indirizzi dal tuo sito o dal tuo programma con una semplice API. Le risposte sono in JSON.

Accesso

Si usa un utente di questo servizio e una password per le applicazioni di WordPress (Profilo → Password per le applicazioni), con l'accesso HTTP "Basic". La password si può revocare in qualsiasi momento.

Accorciare un indirizzo

curl -X POST https://andiamo.li/wp-json/andiamo/v1/links \
  -u "UTENTE:PASSWORD-APPLICAZIONE" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://esempio.it/un-articolo-molto-lungo"}'

La risposta (201 se il link è nuovo, 200 se lo stesso indirizzo era già stato accorciato dallo stesso utente):

{
  "code": "k4m9x",
  "short": "https://andiamo.li/k4m9x",
  "display": "andiamo.li/k4m9x",
  "url": "https://esempio.it/un-articolo-molto-lungo",
  "clicks": 0,
  "existing": false
}

Facoltativo: "alias" sceglie il nome del link (da 4 a 40 caratteri: minuscole, cifre e trattini).

Altre richieste

  • GET https://andiamo.li/wp-json/andiamo/v1/ping — verifica che l'accesso funzioni
  • GET https://andiamo.li/wp-json/andiamo/v1/links — i tuoi link (con page e per_page)
  • GET|DELETE https://andiamo.li/wp-json/andiamo/v1/links/{codice} — dettaglio o eliminazione di un link

Ogni utente può creare un numero limitato di link all'ora; oltre il limite la risposta è 429. Gli errori hanno un codice HTTP (400, 401, 409, 429) e un messaggio.