Zagl Logo

API-documentatie

Kort links in vanuit je eigen code. Eén endpoint, één bearer token.

Eindpunt

POSThttps://za.gl/api/shorten
RESTJSON-bodyBearer-auth

Authenticatie

Geef je API-token mee in de Authorization header als bearer token. Je vindt het in je accountdashboard nadat je je eerste link hebt gemaakt.

Header
Authorization: Bearer YOUR_API_TOKEN

Nog geen token? Je kunt het endpoint ook zonder aanroepen. Za.gl maakt meteen een anoniem account aan en geeft een nieuw token terug in data.newAuthToken. Bewaar het om je links later te beheren.

Aanvraagbody

originalUrlverplicht

string

De lange URL die je wilt inkorten. Laat je het protocol weg, dan zetten we er https:// voor.

customAlias

string

Je eigen einde, bijv. za.gl/mijn-link. Moet uniek zijn, anders krijg je een 409.

password

string

Beveilig de link zodat bezoekers een wachtwoord nodig hebben om verder te gaan.

expiresAt

string (ISO date)

Wanneer de link moet stoppen met werken. Moet in de toekomst liggen.

expiresInMinutes / expiresInHours / expiresInDays

number

Alternatief voor expiresAt, verloopt na een relatieve tijdsduur.

waitTimer

number (0-300)

Seconden die de bezoeker op de previewpagina wacht voor de doorverwijzing.

customGtmId

string

Je eigen Google Tag Manager-ID (GTM-XXXXXXX) die op de previewpagina afgaat.

title / description

string

Optionele metadata die bij de link wordt opgeslagen.

generateQR

boolean

Geef ook een QR-code voor de korte URL terug.

Voorbeeldrequest

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

Voorbeeldresponse

Een geslaagde aanroep geeft 200 OK terug, met de korte URL 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"
  }
}

Rate limits en fouten

10 req/minMaximaal 10 requests per minuut per client.
409De gekozen alias is al bezet.
400Ongeldige URL of een vervaldatum in het verleden.
429Je hebt de rate limit of je maandquotum bereikt.