Documentazione API

Accorcia link direttamente dal tuo codice. Un endpoint, un bearer token.

Endpoint

POSThttps://za.gl/api/shorten

RESTCorpo JSONBearer auth

Autenticazione

Passa il tuo token API nell'intestazione Authorization come bearer token. Lo prendi dalla dashboard del tuo account dopo aver creato il primo link.

Intestazione

Authorization: Bearer YOUR_API_TOKEN

Non hai ancora un token? Puoi chiamare l'endpoint anche senza. Za.gl crea al volo un account anonimo e restituisce un token nuovo in data.newAuthToken. Salvalo per gestire i tuoi link in seguito.

Corpo della richiesta

Campo	Tipo	Descrizione
`originalUrl`obbligatorio	string	L'URL lungo da accorciare. Se ometti il protocollo, https:// viene aggiunto in automatico.
`customAlias`	string	La tua terminazione personalizzata, es. za.gl/my-link. Deve essere unica, altrimenti ricevi un 409.
`password`	string	Protegge il link: chi lo apre deve inserire una password per proseguire.
`expiresAt`	string (ISO date)	Quando il link deve smettere di funzionare. Deve essere una data futura.
`expiresInMinutes / expiresInHours / expiresInDays`	number	In alternativa a expiresAt, scade dopo un intervallo di tempo relativo.
`waitTimer`	number (0-300)	Secondi di attesa sulla pagina di anteprima prima del reindirizzamento.
`customGtmId`	string	Il tuo ID Google Tag Manager (GTM-XXXXXXX) attivato sulla pagina di anteprima.
`title / description`	string	Metadati opzionali salvati insieme al link.
`generateQR`	boolean	Restituisce anche un QR code per il link breve.

originalUrlobbligatorio

string

L'URL lungo da accorciare. Se ometti il protocollo, https:// viene aggiunto in automatico.

customAlias

string

La tua terminazione personalizzata, es. za.gl/my-link. Deve essere unica, altrimenti ricevi un 409.

password

string

Protegge il link: chi lo apre deve inserire una password per proseguire.

expiresAt

string (ISO date)

Quando il link deve smettere di funzionare. Deve essere una data futura.

expiresInMinutes / expiresInHours / expiresInDays

number

In alternativa a expiresAt, scade dopo un intervallo di tempo relativo.

waitTimer

number (0-300)

Secondi di attesa sulla pagina di anteprima prima del reindirizzamento.

customGtmId

string

Il tuo ID Google Tag Manager (GTM-XXXXXXX) attivato sulla pagina di anteprima.

title / description

string

Metadati opzionali salvati insieme al link.

generateQR

boolean

Restituisce anche un QR code per il link breve.

Richiesta di esempio

POSTcURL

curl -X POST https://za.gl/api/shorten \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "password": "optional-secret",
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "waitTimer": 5
  }'

Risposta di esempio

Una chiamata riuscita restituisce 200 OK con il link breve in data.shortUrl.

200 OKJSON

{
  "success": true,
  "message": "URL shortened successfully",
  "data": {
    "id": "123",
    "alias": "my-link",
    "shortUrl": "https://za.gl/my-link",
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "domain": "za.gl",
    "title": "",
    "description": null,
    "hasPassword": true,
    "isActive": true,
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "hits": 0,
    "waitTimer": 5,
    "created": "2026-06-25T10:00:00.000Z",
    "modified": "2026-06-25T10:00:00.000Z",
    "authToken": "your-account-token"
  }
}

Limiti di frequenza ed errori

10 req/minFino a 10 richieste al minuto per client.

409L'alias personalizzato è già occupato.

400URL non valido o data di scadenza già passata.

429Hai raggiunto il limite di frequenza o la quota mensile.