API-dokumentation

Forkort links direkte fra din kode. Ét endpoint, én bearer-token.

Endpoint

POSThttps://za.gl/api/shorten

RESTJSON-bodyBearer-auth

Godkendelse

Send din API-token i headeren Authorization som bearer-token. Du finder den på dit kontrolpanel, når du har oprettet dit første link.

Header

Authorization: Bearer YOUR_API_TOKEN

Ingen token endnu? Du kan kalde endpointet uden. Za.gl opretter en anonym konto med det samme og returnerer en ny token i data.newAuthToken. Gem den, så du kan styre dine links senere.

Request-body

Felt	Type	Beskrivelse
`originalUrl`påkrævet	string	Den lange URL, der skal forkortes. Udelader du protokollen, tilføjes https:// automatisk.
`customAlias`	string	Din egen endelse, f.eks. za.gl/my-link. Den skal være unik, ellers får du en 409.
`password`	string	Beskyt linket, så besøgende skal bruge en adgangskode for at fortsætte.
`expiresAt`	string (ISO date)	Hvornår linket skal holde op med at virke. Tidspunktet skal ligge i fremtiden.
`expiresInMinutes / expiresInHours / expiresInDays`	number	Alternativ til expiresAt, udløber efter en relativ tid.
`waitTimer`	number (0-300)	Sekunder, den besøgende venter på forhåndsvisningen, før viderestillingen sker.
`customGtmId`	string	Dit eget Google Tag Manager-ID (GTM-XXXXXXX), der udløses på forhåndsvisningen.
`title / description`	string	Valgfri metadata gemt sammen med linket.
`generateQR`	boolean	Returnér også en QR-kode til det korte link.

originalUrlpåkrævet

string

Den lange URL, der skal forkortes. Udelader du protokollen, tilføjes https:// automatisk.

customAlias

string

Din egen endelse, f.eks. za.gl/my-link. Den skal være unik, ellers får du en 409.

password

string

Beskyt linket, så besøgende skal bruge en adgangskode for at fortsætte.

expiresAt

string (ISO date)

Hvornår linket skal holde op med at virke. Tidspunktet skal ligge i fremtiden.

expiresInMinutes / expiresInHours / expiresInDays

number

Alternativ til expiresAt, udløber efter en relativ tid.

waitTimer

number (0-300)

Sekunder, den besøgende venter på forhåndsvisningen, før viderestillingen sker.

customGtmId

string

Dit eget Google Tag Manager-ID (GTM-XXXXXXX), der udløses på forhåndsvisningen.

title / description

string

Valgfri metadata gemt sammen med linket.

generateQR

boolean

Returnér også en QR-kode til det korte link.

Eksempel på request

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

Eksempel på svar

Et vellykket kald returnerer 200 OK med det korte link i 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 og fejl

10 req/minOp til 10 requests i minuttet pr. klient.

409Det valgte alias er allerede taget.

400Ugyldig URL eller en udløbsdato i fortiden.

429Du har ramt rate limit eller din månedlige kvote.