Zagl logó

API dokumentáció

Rövidíts linkeket egyenesen a kódodból. Egy végpont, egy bearer token.

Végpont

POSThttps://za.gl/api/shorten
RESTJSON törzsBearer hitelesítés

Hitelesítés

Add át az API tokened a Authorization fejlécben, bearer tokenként. Az első link létrehozása után a fiókod vezérlőpultján találod.

Fejléc
Authorization: Bearer YOUR_API_TOKEN

Még nincs tokened? Anélkül is hívhatod a végpontot. A Za.gl menet közben létrehoz egy névtelen fiókot, és friss tokent ad vissza itt: data.newAuthToken. Mentsd el, hogy később kezelni tudd a linkjeidet.

Kérés törzse

originalUrlkötelező

string

A rövidítendő hosszú URL. Ha lehagyod a protokollt, a https:// automatikusan bekerül.

customAlias

string

Saját végződés, pl. za.gl/sajat-link. Egyedinek kell lennie, különben 409-et kapsz.

password

string

Védd le a linket, hogy a látogatóknak jelszó kelljen a továbblépéshez.

expiresAt

string (ISO date)

Mikor szűnjön meg a link. Jövőbeli időpont kell.

expiresInMinutes / expiresInHours / expiresInDays

number

Az expiresAt alternatívája: lejárat adott idő elteltével.

waitTimer

number (0-300)

Hány másodpercet vár a látogató az előnézeti oldalon az átirányítás előtt.

customGtmId

string

Saját Google Tag Manager azonosítód (GTM-XXXXXXX), ami az előnézeti oldalon fut le.

title / description

string

Opcionális metaadat, amit a linkkel együtt tárolunk.

generateQR

boolean

QR-kódot is visszaad a rövid URL-hez.

Példakérés

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

Példaválasz

A sikeres hívás 200 OK választ ad, a rövid URL pedig ebben a mezőben van: 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"
  }
}

Korlátok és hibák

10 req/minKliensenként legfeljebb 10 kérés percenként.
409Az egyedi alias már foglalt.
400Érvénytelen URL vagy múltbeli lejárati dátum.
429Elérted a percenkénti korlátot vagy a havi kereted.