Zagl Logo

Dokumentasyon ng API

Magpaikli ng link diretso mula sa code mo. Isang endpoint, isang bearer token.

Endpoint

POSThttps://za.gl/api/shorten
RESTNilalamang JSONBearer auth

Pagpapatunay

Ilagay ang API token mo sa Authorization header bilang bearer token. Kunin ito sa dashboard ng account mo pagkatapos mong gawin ang unang link.

Header
Authorization: Bearer YOUR_API_TOKEN

Wala pang token? Puwede mong tawagin ang endpoint kahit wala. Gagawa ang Za.gl ng anonymous account agad at ibabalik ang bagong token sa data.newAuthToken. I-save ito para mapamahalaan mo ang mga link mo mamaya.

Body ng request

originalUrlkailangan

string

Ang mahabang URL na papaikliin. Kung wala kang inilagay na protocol, idadagdag ang https:// para sa iyo.

customAlias

string

Sarili mong ending, hal. za.gl/my-link. Dapat unique, kung hindi ay makakakuha ka ng 409.

password

string

Protektahan ang link para kailanganin ng bisita ang password bago magpatuloy.

expiresAt

string (ISO date)

Kung kailan dapat huminto sa paggana ang link. Dapat nasa hinaharap.

expiresInMinutes / expiresInHours / expiresInDays

number

Alternatibo sa expiresAt, mag-e-expire pagkalipas ng tinakdang haba ng oras.

waitTimer

number (0-300)

Segundong hihintayin ng bisita sa preview page bago ang redirect.

customGtmId

string

Sarili mong Google Tag Manager ID (GTM-XXXXXXX) na pinapaandar sa preview page.

title / description

string

Opsyonal na metadata na naka-imbak kasama ang link.

generateQR

boolean

Magbalik din ng QR code para sa short URL.

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

Halimbawang response

Nagbabalik ang matagumpay na tawag ng 200 OK kasama ang short URL sa 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 at errors

10 req/minHanggang 10 request kada minuto bawat client.
409Kuha na ang custom alias na iyan.
400Invalid na URL o lumipas na ang expiration date.
429Naabot mo na ang rate limit o ang buwanang quota mo.