Zagl-logo

API-dokumentasjon

Kort ned lenker rett fra koden din. Ett endepunkt, én bearer-token.

Endepunkt

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

Autentisering

Send API-tokenet ditt i Authorization header som en bearer-token. Du finner det i kontrollpanelet på kontoen din etter at du har laget din første lenke.

Header
Authorization: Bearer YOUR_API_TOKEN

Har du ingen token ennå? Du kan kalle endepunktet uten. Za.gl lager en anonym konto der og da, og returnerer en fersk token i data.newAuthToken. Lagre den for å styre lenkene dine senere.

Innhold i forespørselen

originalUrlpåkrevd

string

Den lange URL-en som skal kortes ned. Utelater du protokollen, legges https:// til for deg.

customAlias

string

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

password

string

Beskytt lenken, slik at besøkende trenger passord for å gå videre.

expiresAt

string (ISO date)

Når lenken skal slutte å virke. Må være fram i tid.

expiresInMinutes / expiresInHours / expiresInDays

number

Alternativ til expiresAt, utløper etter en gitt tid.

waitTimer

number (0-300)

Sekunder den besøkende venter på forhåndsvisningssiden før videresendingen.

customGtmId

string

Din egen Google Tag Manager-ID (GTM-XXXXXXX) som utløses på forhåndsvisningssiden.

title / description

string

Valgfrie metadata som lagres sammen med lenken.

generateQR

boolean

Returner også en QR-kode for den korte URL-en.

Eksempel på forespørsel

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 kall returnerer 200 OK med den korte URL-en 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"
  }
}

Forespørselsgrenser og feil

10 req/minOpptil 10 forespørsler i minuttet per klient.
409Aliaset er allerede tatt.
400Ugyldig URL eller en utløpsdato som allerede har passert.
429Du nådde forespørselsgrensen eller månedskvoten din.