API dokumentacija

Trumpinkite nuorodas tiesiai iš savo kodo. Vienas galinis taškas, vienas bearer raktas.

Galinis taškas

POSThttps://za.gl/api/shorten

RESTJSON turinysBearer autentifikavimas

Autentifikavimas

Savo API raktą perduokite Authorization antraštėje kaip bearer raktą. Rasite jį paskyros skydelyje, kai sukursite pirmą nuorodą.

Antraštė

Authorization: Bearer YOUR_API_TOKEN

Dar neturite rakto? Galinį tašką galite kviesti ir be jo. Za.gl iškart sukuria anoniminę paskyrą ir grąžina naują raktą lauke data.newAuthToken. Išsaugokite jį, kad vėliau galėtumėte tvarkyti savo nuorodas.

Užklausos turinys

Laukas	Tipas	Aprašymas
`originalUrl`privalomas	string	Ilgas URL, kurį reikia sutrumpinti. Jei nenurodysite protokolo, https:// bus pridėtas automatiškai.
`customAlias`	string	Jūsų pasirinkta pabaiga, pvz., za.gl/my-link. Turi būti unikali, kitaip gausite 409.
`password`	string	Apsaugokite nuorodą, kad lankytojams reikėtų slaptažodžio norint tęsti.
`expiresAt`	string (ISO date)	Kada nuoroda turi nustoti veikti. Data turi būti ateityje.
`expiresInMinutes / expiresInHours / expiresInDays`	number	Alternatyva expiresAt: nuoroda nustoja veikti po nurodyto laiko.
`waitTimer`	number (0-300)	Sekundės, kurias lankytojas laukia peržiūros puslapyje iki nukreipimo.
`customGtmId`	string	Jūsų Google Tag Manager ID (GTM-XXXXXXX), suveikiantis peržiūros puslapyje.
`title / description`	string	Nebūtini metaduomenys, saugomi kartu su nuoroda.
`generateQR`	boolean	Kartu grąžinti ir QR kodą trumpajai nuorodai.

originalUrlprivalomas

string

Ilgas URL, kurį reikia sutrumpinti. Jei nenurodysite protokolo, https:// bus pridėtas automatiškai.

customAlias

string

Jūsų pasirinkta pabaiga, pvz., za.gl/my-link. Turi būti unikali, kitaip gausite 409.

password

string

Apsaugokite nuorodą, kad lankytojams reikėtų slaptažodžio norint tęsti.

expiresAt

string (ISO date)

Kada nuoroda turi nustoti veikti. Data turi būti ateityje.

expiresInMinutes / expiresInHours / expiresInDays

number

Alternatyva expiresAt: nuoroda nustoja veikti po nurodyto laiko.

waitTimer

number (0-300)

Sekundės, kurias lankytojas laukia peržiūros puslapyje iki nukreipimo.

customGtmId

string

Jūsų Google Tag Manager ID (GTM-XXXXXXX), suveikiantis peržiūros puslapyje.

title / description

string

Nebūtini metaduomenys, saugomi kartu su nuoroda.

generateQR

boolean

Kartu grąžinti ir QR kodą trumpajai nuorodai.

Užklausos pavyzdys

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
  }'

Atsakymo pavyzdys

Sėkminga užklausa grąžina 200 OK su trumpąja nuoroda lauke 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"
  }
}

Užklausų limitai ir klaidos

10 req/minIki 10 užklausų per minutę vienam klientui.

409Pasirinkta pabaiga jau užimta.

400Netinkamas URL arba praėjusi galiojimo data.

429Pasiekėte užklausų limitą arba mėnesio kvotą.