API link corti - documentazione

API JSON per creare e consultare link corti. Usa la chiave API del tuo account (o l’API_TOKEN della piattaforma se applicabile).

API pubblica: https://anyurl.bond - JSON sotto /api/v1/.

Authorization

Authorization: Bearer 1234

Invia la chiave API esatta in Authorization: Bearer. L’accesso alla dashboard usa la stessa chiave con la tua e-mail.

POST /api/v1/shorten

{"long_url":"https://example.com","expiration_time":"24h","max_uses":100,"allow_bots":false}

{"long_url":"https://example.com","permanent":true}

expiration_time e max_uses facoltativi valgono per il piano a pagamento. Senza pagamento, i nuovi link hanno un tetto mensile (UTC, reset il giorno 1) e scadono dopo ~10 minuti indipendentemente dal corpo.

GET /api/v1/info/{short_code}

Restituisce metadati e validità di un codice breve senza incrementare i clic.

GET /api/v1/me

Restituisce il piano, i limiti effettivi dal pannello e l’uso del mese (UTC): nuovi link e modifiche API.

GET /api/v1/links

?limit=50&offset=0

Elenca solo i link corti creati con la chiave API del tuo account (owner_id coincide con quella chiave; stesso ambito di GET /info). Il token API della piattaforma non può usare questo endpoint. Parametri opzionali: limit (predefinito 50, max 100), offset (predefinito 0, max 100000). JSON: links (stessi campi di GET /info per elemento), total, limit, offset. L’elenco non cancella righe né incrementa i clic.

PUT / PATCH /api/v1/info/{short_code}

{"long_url":"https://example.com/new","expiration_time":"24h","max_uses":20,"allow_bots":false}

Per modificare un codice corto esistente usa PUT o PATCH su /api/v1/info/{short_code}, non POST /shorten. Corpo JSON: uno qualsiasi tra long_url, expiration_time, max_uses, allow_bots. Ometti un campo per lasciarlo invariato. Rimuovi la scadenza temporale con expiration_time ""; usi illimitati con max_uses -1. La risposta segue GET /info.

Esempi da riga di comando (curl)

Il token 1234 è solo un esempio - usa la tua vera chiave API. Host: https://anyurl.bond.

POST /api/v1/shorten - JSON completo (host https://anyurl.bond)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"expiration_time\":\"24h\",\"max_uses\":100,\"allow_bots\":false}"

POST /api/v1/shorten - corpo minimo (a pagamento: scadenza predefinita 24 h)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

POST /api/v1/shorten - permanente (a pagamento; conta come modifica smart)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"permanent\":true}"

GET /api/v1/info/{short_code} - esempio codice corto abc123

curl -sS 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234'

GET /api/v1/me

curl -sS 'https://anyurl.bond/api/v1/me' \
  -H 'Authorization: Bearer 1234'

GET /api/v1/links - pagina i tuoi link corti

curl -sS 'https://anyurl.bond/api/v1/links?limit=50&offset=0' \
  -H 'Authorization: Bearer 1234'

PATCH /api/v1/info/{short_code}

curl -sS -X PATCH 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated-destination\"}"

PUT /api/v1/info/{short_code}

curl -sS -X PUT 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated\",\"expiration_time\":\"7d\",\"max_uses\":50,\"allow_bots\":true}"

Verbose (-v) per il debug

curl -v -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

Piano API gratuito: fino a 100 nuovi link corti al mese di calendario (UTC); il contatore si azzera il giorno 1. Ogni link scade dopo circa 10 minuti. I piani a pagamento seguono lo stesso ciclo mensile.

Torna alla home · Termini e condizioni