Zagl Logo

Dokumentace API

Zkracujte odkazy přímo z kódu. Jeden endpoint, jeden bearer token.

Endpoint

POSThttps://za.gl/api/shorten
RESTTělo JSONBearer auth

Ověření

Svůj API token předejte v hlavičce Authorization jako bearer token. Najdete ho na nástěnce účtu, jakmile vytvoříte první odkaz.

Hlavička
Authorization: Bearer YOUR_API_TOKEN

Nemáte token? Endpoint jde zavolat i bez něj. Za.gl rovnou založí anonymní účet a nový token vrátí v poli data.newAuthToken. Uložte si ho, ať můžete odkazy spravovat i později.

Tělo požadavku

originalUrlpovinné

string

Dlouhá URL ke zkrácení. Když vynecháte protokol, doplní se https://.

customAlias

string

Vlastní koncovka, např. za.gl/my-link. Musí být unikátní, jinak dostanete 409.

password

string

Zabezpečte odkaz, aby návštěvník musel pro pokračování zadat heslo.

expiresAt

string (ISO date)

Kdy má odkaz přestat fungovat. Musí být v budoucnosti.

expiresInMinutes / expiresInHours / expiresInDays

number

Alternativa k expiresAt, vypršení po zadané době.

waitTimer

number (0-300)

Kolik sekund návštěvník čeká na náhledové stránce před přesměrováním.

customGtmId

string

Vlastní ID Google Tag Manager (GTM-XXXXXXX), které se spustí na náhledové stránce.

title / description

string

Nepovinná metadata uložená k odkazu.

generateQR

boolean

Vrátit ke krátké URL i QR kód.

Ukázkový požadavek

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

Ukázková odpověď

Úspěšné volání vrátí 200 OK s krátkou URL v poli 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"
  }
}

Limity a chyby

10 req/minAž 10 požadavků za minutu na klienta.
409Vlastní alias je už obsazený.
400Neplatná URL nebo datum vypršení v minulosti.
429Narazili jste na limit požadavků nebo na měsíční kvótu.