Documentație API

Scurtezi linkuri direct din codul tău. Un singur punct de acces, un singur token.

Punct de acces

POSThttps://za.gl/api/shorten

RESTcorp JSONautentificare bearer

Autentificare

Trimite tokenul de API în antetul Authorization ca token bearer. Îl iei din panoul contului tău, după ce faci primul link.

Antet

Authorization: Bearer YOUR_API_TOKEN

N-ai încă token? Poți apela punctul de acces fără el. Za.gl creează pe loc un cont anonim și returnează un token nou în data.newAuthToken. Salvează-l ca să-ți gestionezi linkurile mai târziu.

Corpul cererii

Câmp	Tip	Descriere
`originalUrl`obligatoriu	string	Adresa lungă de scurtat. Dacă lași protocolul deoparte, se adaugă https:// automat.
`customAlias`	string	Terminația ta, de exemplu za.gl/my-link. Trebuie să fie unică, altfel primești 409.
`password`	string	Protejezi linkul, iar vizitatorii au nevoie de parolă ca să meargă mai departe.
`expiresAt`	string (ISO date)	Când se oprește linkul. Trebuie să fie o dată din viitor.
`expiresInMinutes / expiresInHours / expiresInDays`	number	Alternativă la expiresAt, expiră după un interval de timp.
`waitTimer`	number (0-300)	Secundele pe care vizitatorul le așteaptă pe pagina de așteptare, înainte de redirectare.
`customGtmId`	string	Propriul tău identificator Google Tag Manager (GTM-XXXXXXX), pornit pe pagina de așteptare.
`title / description`	string	Date opționale, păstrate împreună cu linkul.
`generateQR`	boolean	Returnează și un cod QR pentru linkul scurt.

originalUrlobligatoriu

string

Adresa lungă de scurtat. Dacă lași protocolul deoparte, se adaugă https:// automat.

customAlias

string

Terminația ta, de exemplu za.gl/my-link. Trebuie să fie unică, altfel primești 409.

password

string

Protejezi linkul, iar vizitatorii au nevoie de parolă ca să meargă mai departe.

expiresAt

string (ISO date)

Când se oprește linkul. Trebuie să fie o dată din viitor.

expiresInMinutes / expiresInHours / expiresInDays

number

Alternativă la expiresAt, expiră după un interval de timp.

waitTimer

number (0-300)

Secundele pe care vizitatorul le așteaptă pe pagina de așteptare, înainte de redirectare.

customGtmId

string

Propriul tău identificator Google Tag Manager (GTM-XXXXXXX), pornit pe pagina de așteptare.

title / description

string

Date opționale, păstrate împreună cu linkul.

generateQR

boolean

Returnează și un cod QR pentru linkul scurt.

Exemplu de cerere

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

Exemplu de răspuns

Un apel reușit returnează 200 OK cu linkul scurt în 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"
  }
}

Limite de rată și erori

10 req/minCel mult 10 cereri pe minut, de client.

409Aliasul ales e deja luat.

400Adresă nevalidă sau dată de expirare din trecut.

429Ai atins limita de rată sau cota lunară.