Sviluppatori

REST API

Crea link brevi, leggi le statistiche dei clic e genera codici QR dal tuo codice. JSON su HTTPS e un'unica intestazione per l'autenticazione.

Ottieni una chiave API Provalo dal vivo OpenAPI

URL di base: https://urlik.xyz/api/
Autenticazione: X-Api-Key
Formato: JSON · UTF-8
Metodi: 10
Webhooks: Webhook

Sviluppatori

Guida rapida

Il tuo primo link breve in una richiesta.

Ottieni una chiave
Creala nel tuo account sotto API. Le chiavi possono essere limitate a specifici ambiti.
Invia la richiesta
POST l'URL lungo con l'intestazione X-Api-Key, e un alias se ne vuoi uno.
Usa il risultato
return.url è il link breve, return.qr il suo codice QR e return.stats la pagina delle statistiche pubbliche.

Tieni la chiave sul tuo server: chiunque la veda può creare e modificare link nel tuo account.

Accedi per una chiave

La tua prima richiesta

POST /api/getLink.json

curl -X POST https://urlik.xyz/api/getLink.json \
  -H "X-Api-Key: $URLIK_KEY" \
  -d "url=https://example.com/spring-sale" \
  -d "alias=spring" \
  -d "mode=redirect"

const res = await fetch("https://urlik.xyz/api/getLink.json", {
  method: "POST",
  headers: { "X-Api-Key": process.env.URLIK_KEY },
  body: new URLSearchParams({ url: "https://example.com/spring-sale", alias: "spring" })
});
const data = await res.json();
console.log(data.return.url);   // https://urlik.xyz/spring

$ch = curl_init("https://urlik.xyz/api/getLink.json");
curl_setopt_array($ch, [
  CURLOPT_POST           => true,
  CURLOPT_HTTPHEADER     => ["X-Api-Key: " . getenv("URLIK_KEY")],
  CURLOPT_POSTFIELDS     => ["url" => "https://example.com/spring-sale", "alias" => "spring"],
  CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
echo $data["return"]["url"];   // https://urlik.xyz/spring

import os, requests

r = requests.post(
    "https://urlik.xyz/api/getLink.json",
    headers={"X-Api-Key": os.environ["URLIK_KEY"]},
    data={"url": "https://example.com/spring-sale", "alias": "spring"},
)
print(r.json()["return"]["url"])   # https://urlik.xyz/spring

Risposta200 OK

{
  "status": "success",
  "return": {
    "hex":   "spring",
    "url":   "https://urlik.xyz/spring",
    "qr":    "https://urlik.xyz/qr/spring.png",
    "stats": "https://urlik.xyz/spring+",
    "mode":  "redirect"
  }
}

Autenticazione

Invia la tua chiave nell'intestazione X-Api-Key. La riduzione di base funziona senza una chiave; i link creati con una chiave appartengono al tuo account.

X-Api-Key: YOUR_KEY

Formato della risposta

Ogni metodo risponde con JSON: lo stato è successo o errore, il messaggio spiega un errore, il ritorno contiene i dati.

{ "status": "success", "message": "...", "return": { ... } }

Link

POST/api/getLink.jsonCrea un link breveChiave opzionale

Parametro	Richiesto	Descrizione
`url`	richiesto	URL di destinazione, http o https
`alias`	opzionale	Codice personalizzato, 2–32 caratteri: lettere, cifre, _ e -
`mode`	opzionale	reindirizza (predefinito), anteprima o frame
`expire`	opzionale	Durata in secondi, 0 significa nessuna scadenza
`password`	opzionale	Password che i visitatori devono inserire per continuare

POST /api/getLink.json

curl -X POST https://urlik.xyz/api/getLink.json -H "X-Api-Key: $URLIK_KEY" \
  -d "url=https://example.com/spring-sale"

const res = await fetch("https://urlik.xyz/api/getLink.json", {
  method: "POST",
  headers: { "X-Api-Key": process.env.URLIK_KEY },
  body: new URLSearchParams({ url: "https://example.com/spring-sale" })
});
console.log(await res.json());

$ch = curl_init("https://urlik.xyz/api/getLink.json");
curl_setopt_array($ch, [
  CURLOPT_POST           => true,
  CURLOPT_HTTPHEADER     => ["X-Api-Key: " . getenv("URLIK_KEY")],
  CURLOPT_POSTFIELDS     => ["url" => "https://example.com/spring-sale"],
  CURLOPT_RETURNTRANSFER => true,
]);
print_r(json_decode(curl_exec($ch), true));

import os, requests

r = requests.post(
    "https://urlik.xyz/api/getLink.json",
    headers={"X-Api-Key": os.environ["URLIK_KEY"]},
    data={"url": "https://example.com/spring-sale"},
)
print(r.json())

POST/api/stats.jsonStatistiche del link: clic per giorno, fonti, dispositivi e browserChiave opzionale

Parametro	Richiesto	Descrizione
`code`	richiesto	Codice breve del link

POST /api/stats.json

curl -X POST https://urlik.xyz/api/stats.json -H "X-Api-Key: $URLIK_KEY" \
  -d "code=spring"

const res = await fetch("https://urlik.xyz/api/stats.json", {
  method: "POST",
  headers: { "X-Api-Key": process.env.URLIK_KEY },
  body: new URLSearchParams({ code: "spring" })
});
console.log(await res.json());

$ch = curl_init("https://urlik.xyz/api/stats.json");
curl_setopt_array($ch, [
  CURLOPT_POST           => true,
  CURLOPT_HTTPHEADER     => ["X-Api-Key: " . getenv("URLIK_KEY")],
  CURLOPT_POSTFIELDS     => ["code" => "spring"],
  CURLOPT_RETURNTRANSFER => true,
]);
print_r(json_decode(curl_exec($ch), true));

import os, requests

r = requests.post(
    "https://urlik.xyz/api/stats.json",
    headers={"X-Api-Key": os.environ["URLIK_KEY"]},
    data={"code": "spring"},
)
print(r.json())

POST/api/links.jsonElenca i tuoi linkChiave richiesta

Nessun parametro: la chiave identifica il tuo account.

POST /api/links.json

curl -X POST https://urlik.xyz/api/links.json -H "X-Api-Key: $URLIK_KEY"

const res = await fetch("https://urlik.xyz/api/links.json", {
  method: "POST",
  headers: { "X-Api-Key": process.env.URLIK_KEY },
  body: new URLSearchParams({  })
});
console.log(await res.json());

$ch = curl_init("https://urlik.xyz/api/links.json");
curl_setopt_array($ch, [
  CURLOPT_POST           => true,
  CURLOPT_HTTPHEADER     => ["X-Api-Key: " . getenv("URLIK_KEY")],
  CURLOPT_POSTFIELDS     => [],
  CURLOPT_RETURNTRANSFER => true,
]);
print_r(json_decode(curl_exec($ch), true));

import os, requests

r = requests.post(
    "https://urlik.xyz/api/links.json",
    headers={"X-Api-Key": os.environ["URLIK_KEY"]},
    data={},
)
print(r.json())

POST/api/update.jsonCambia un linkChiave richiesta

Parametro	Richiesto	Descrizione
`code`	richiesto	Codice breve del link
`url, mode, expire, password`	opzionale	Nuovi valori dei campi che desideri modificare

POST /api/update.json

curl -X POST https://urlik.xyz/api/update.json -H "X-Api-Key: $URLIK_KEY" \
  -d "code=spring"

const res = await fetch("https://urlik.xyz/api/update.json", {
  method: "POST",
  headers: { "X-Api-Key": process.env.URLIK_KEY },
  body: new URLSearchParams({ code: "spring" })
});
console.log(await res.json());

$ch = curl_init("https://urlik.xyz/api/update.json");
curl_setopt_array($ch, [
  CURLOPT_POST           => true,
  CURLOPT_HTTPHEADER     => ["X-Api-Key: " . getenv("URLIK_KEY")],
  CURLOPT_POSTFIELDS     => ["code" => "spring"],
  CURLOPT_RETURNTRANSFER => true,
]);
print_r(json_decode(curl_exec($ch), true));

import os, requests

r = requests.post(
    "https://urlik.xyz/api/update.json",
    headers={"X-Api-Key": os.environ["URLIK_KEY"]},
    data={"code": "spring"},
)
print(r.json())

POST/api/delete.jsonElimina un linkChiave richiesta

Parametro	Richiesto	Descrizione
`code`	richiesto	Codice breve del link

POST /api/delete.json

curl -X POST https://urlik.xyz/api/delete.json -H "X-Api-Key: $URLIK_KEY" \
  -d "code=spring"

const res = await fetch("https://urlik.xyz/api/delete.json", {
  method: "POST",
  headers: { "X-Api-Key": process.env.URLIK_KEY },
  body: new URLSearchParams({ code: "spring" })
});
console.log(await res.json());

$ch = curl_init("https://urlik.xyz/api/delete.json");
curl_setopt_array($ch, [
  CURLOPT_POST           => true,
  CURLOPT_HTTPHEADER     => ["X-Api-Key: " . getenv("URLIK_KEY")],
  CURLOPT_POSTFIELDS     => ["code" => "spring"],
  CURLOPT_RETURNTRANSFER => true,
]);
print_r(json_decode(curl_exec($ch), true));

import os, requests

r = requests.post(
    "https://urlik.xyz/api/delete.json",
    headers={"X-Api-Key": os.environ["URLIK_KEY"]},
    data={"code": "spring"},
)
print(r.json())

Media, QR e posta temporanea

Questi metodi necessitano dell'intestazione X-Api-Key o di una chiamata tramite RapidAPI.

GET/api/download.jsonScarica video o foto da oltre 1000 siti: formati con link di download firmatiChiave richiesta

Parametro	Richiesto	Descrizione
`url`	richiesto	Indirizzo di una pagina con video o foto

GET /api/download.json

curl -H "X-Api-Key: $URLIK_KEY" "https://urlik.xyz/api/download.json?url=https%3A%2F%2Fexample.com%2Fspring-sale"

const res = await fetch("https://urlik.xyz/api/download.json?" + new URLSearchParams({ url: "https://example.com/spring-sale" }), {
  headers: { "X-Api-Key": process.env.URLIK_KEY }
});
console.log(await res.json());

$ch = curl_init("https://urlik.xyz/api/download.json?" . http_build_query(["url" => "https://example.com/spring-sale"]));
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER     => ["X-Api-Key: " . getenv("URLIK_KEY")],
  CURLOPT_RETURNTRANSFER => true,
]);
print_r(json_decode(curl_exec($ch), true));

import os, requests

r = requests.get(
    "https://urlik.xyz/api/download.json",
    headers={"X-Api-Key": os.environ["URLIK_KEY"]},
    params={"url": "https://example.com/spring-sale"},
)
print(r.json())

GET/api/qr.jsonGenera un codice QR in PNG o SVGChiave richiesta

Parametro	Richiesto	Descrizione
`data`	richiesto	Testo o indirizzo da codificare
`format`	opzionale	png o svg
`fg, bg`	opzionale	Colore di primo piano e sfondo, esadecimale
`ecc`	opzionale	Correzione degli errori: L, M, Q o H
`size`	opzionale	Dimensione dell'immagine in pixel

GET /api/qr.json

curl -H "X-Api-Key: $URLIK_KEY" "https://urlik.xyz/api/qr.json?data=https%3A%2F%2Furlik.xyz"

const res = await fetch("https://urlik.xyz/api/qr.json?" + new URLSearchParams({ data: "https://urlik.xyz" }), {
  headers: { "X-Api-Key": process.env.URLIK_KEY }
});
console.log(await res.json());

$ch = curl_init("https://urlik.xyz/api/qr.json?" . http_build_query(["data" => "https://urlik.xyz"]));
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER     => ["X-Api-Key: " . getenv("URLIK_KEY")],
  CURLOPT_RETURNTRANSFER => true,
]);
print_r(json_decode(curl_exec($ch), true));

import os, requests

r = requests.get(
    "https://urlik.xyz/api/qr.json",
    headers={"X-Api-Key": os.environ["URLIK_KEY"]},
    params={"data": "https://urlik.xyz"},
)
print(r.json())

GET/api/mailbox.jsonOttieni o crea un indirizzo temporaneoChiave richiesta

Parametro	Richiesto	Descrizione
`address \| username`	opzionale	Indirizzo temporaneo o il nome per uno nuovo; vuoto crea un indirizzo casuale

GET /api/mailbox.json

curl -H "X-Api-Key: $URLIK_KEY" "https://urlik.xyz/api/mailbox.json?address=demo%40example.com"

const res = await fetch("https://urlik.xyz/api/mailbox.json?" + new URLSearchParams({ address: "[email protected]" }), {
  headers: { "X-Api-Key": process.env.URLIK_KEY }
});
console.log(await res.json());

$ch = curl_init("https://urlik.xyz/api/mailbox.json?" . http_build_query(["address" => "[email protected]"]));
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER     => ["X-Api-Key: " . getenv("URLIK_KEY")],
  CURLOPT_RETURNTRANSFER => true,
]);
print_r(json_decode(curl_exec($ch), true));

import os, requests

r = requests.get(
    "https://urlik.xyz/api/mailbox.json",
    headers={"X-Api-Key": os.environ["URLIK_KEY"]},
    params={"address": "[email protected]"},
)
print(r.json())

GET/api/messages.jsonElenca i messaggi in una casella di posta temporaneaChiave richiesta

Parametro	Richiesto	Descrizione
`address`	richiesto	Indirizzo temporaneo

GET /api/messages.json

curl -H "X-Api-Key: $URLIK_KEY" "https://urlik.xyz/api/messages.json?address=demo%40example.com"

const res = await fetch("https://urlik.xyz/api/messages.json?" + new URLSearchParams({ address: "[email protected]" }), {
  headers: { "X-Api-Key": process.env.URLIK_KEY }
});
console.log(await res.json());

$ch = curl_init("https://urlik.xyz/api/messages.json?" . http_build_query(["address" => "[email protected]"]));
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER     => ["X-Api-Key: " . getenv("URLIK_KEY")],
  CURLOPT_RETURNTRANSFER => true,
]);
print_r(json_decode(curl_exec($ch), true));

import os, requests

r = requests.get(
    "https://urlik.xyz/api/messages.json",
    headers={"X-Api-Key": os.environ["URLIK_KEY"]},
    params={"address": "[email protected]"},
)
print(r.json())

GET/api/message.jsonLeggi un singolo messaggioChiave richiesta

Parametro	Richiesto	Descrizione
`address`	richiesto	Indirizzo temporaneo
`id`	richiesto	ID messaggio dall'elenco della casella di posta

GET /api/message.json

curl -H "X-Api-Key: $URLIK_KEY" "https://urlik.xyz/api/message.json?address=demo%40example.com&id=1"

const res = await fetch("https://urlik.xyz/api/message.json?" + new URLSearchParams({ address: "[email protected]", id: "1" }), {
  headers: { "X-Api-Key": process.env.URLIK_KEY }
});
console.log(await res.json());

$ch = curl_init("https://urlik.xyz/api/message.json?" . http_build_query(["address" => "[email protected]", "id" => "1"]));
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER     => ["X-Api-Key: " . getenv("URLIK_KEY")],
  CURLOPT_RETURNTRANSFER => true,
]);
print_r(json_decode(curl_exec($ch), true));

import os, requests

r = requests.get(
    "https://urlik.xyz/api/message.json",
    headers={"X-Api-Key": os.environ["URLIK_KEY"]},
    params={"address": "[email protected]", "id": "1"},
)
print(r.json())

Swagger UI

Provalo dal vivo

Esplora e chiama ogni endpoint proprio qui. Incolla la tua chiave API con il pulsante Autorizza per eseguire richieste autenticate.

Incorpora l'accorciatore

Inserisci questo frammento in qualsiasi pagina per aggiungere un accorciatore di URL funzionante con un link di ritorno a urlik.xyz:

/embed

HTML

<iframe src="https://urlik.xyz/embed" style="width:100%;max-width:520px;height:150px;border:0" title="URL shortener by urlik.xyz" loading="lazy"></iframe>

Domande e risposte

Una semplice API REST per link brevi

L'API REST di Urlik ti consente di creare, leggere, aggiornare ed eliminare link brevi dal tuo codice e di estrarre statistiche sui clic in formato JSON. È una semplice API HTTPS: invia una richiesta POST, ricevi una risposta JSON prevedibile, quindi funziona da qualsiasi linguaggio o piattaforma.

Le esigenze di accorciamento di base non richiedono credenziali. Per collegare i link al tuo account e gestirli in seguito, invia la tua chiave nell'intestazione X-Api-Key, che troverai nel tuo account. Le risposte seguono sempre lo stesso stato, messaggio e forma di ritorno mostrati di seguito.

Ho bisogno di una chiave API?

Non per l'accorciamento di base: puoi creare un link in modo anonimo. Una chiave, trovata nel tuo account, collega i link a te ed è necessaria per elencarli, aggiornarli o eliminarli.

In che formato sono le risposte?

Ogni endpoint restituisce JSON con uno stato, un messaggio leggibile dall'uomo e un oggetto di ritorno contenente i dati, quindi il parsing è coerente tra le chiamate.

C'è un limite di richiesta?

Sì, le richieste sono limitate per chiamante per mantenere il servizio veloce e equo. Le chiavi autenticate ottengono un'assegnazione maggiore rispetto al traffico anonimo.

Posso usarlo da qualsiasi linguaggio?

Sì. È un'API JSON HTTPS standard, quindi qualsiasi cosa possa inviare una richiesta POST — curl, Python, PHP, JavaScript o Go — può usarla.

Urlik riunisce un insieme di strumenti web veloci e rispettosi della privacy in un unico posto, così puoi gestire le attività quotidiane sui link senza dover gestire servizi separati o creare account. Che tu stia condividendo una campagna, raccogliendo un pagamento, verificando un'iscrizione o inviando un file riservato, c'è uno strumento dedicato e gratuito pronto per il lavoro.

Cosa risponde questa pagina

API dell'accorciatore di link
dettagli su API dell'accorciatore di link
API dell'accorciatore di link 2026
API dell'accorciatore di link su urlik.xyz
cosa include API dell'accorciatore di link
API dell'accorciatore di link spiegato
domande e risposte su API dell'accorciatore di link
API dell'accorciatore di link in linguaggio semplice
cosa sapere su API dell'accorciatore di link
API dell'accorciatore di link online
come funziona API dell'accorciatore di link
dove trovare API dell'accorciatore di link

Prodotti

Risorse