Logo Zagl

Dokumentasi API

Pendekkan tautan langsung dari kode Anda. Satu endpoint, satu bearer token.

Endpoint

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

Autentikasi

Kirim token API Anda di header Authorization sebagai bearer token. Ambil dari dashboard akun Anda setelah Anda membuat tautan pertama.

Header
Authorization: Bearer YOUR_API_TOKEN

Belum punya token? Anda tetap bisa memanggil endpoint tanpa token. Za.gl langsung membuat akun anonim dan mengembalikan token baru di data.newAuthToken. Simpan token itu untuk mengelola tautan Anda nanti.

Body permintaan

originalUrlwajib

string

URL panjang yang mau dipendekkan. Kalau protokolnya tidak ditulis, https:// ditambahkan otomatis.

customAlias

string

Akhiran Anda sendiri, misal za.gl/tautan-saya. Harus unik, kalau tidak Anda dapat 409.

password

string

Lindungi tautan agar pengunjung perlu kata sandi untuk lanjut.

expiresAt

string (ISO date)

Kapan tautan berhenti berfungsi. Harus waktu di masa depan.

expiresInMinutes / expiresInHours / expiresInDays

number

Alternatif expiresAt, kedaluwarsa setelah jangka waktu tertentu.

waitTimer

number (0-300)

Detik yang ditunggu pengunjung di halaman pratinjau sebelum dialihkan.

customGtmId

string

ID Google Tag Manager Anda sendiri (GTM-XXXXXXX) yang dijalankan di halaman pratinjau.

title / description

string

Metadata opsional yang disimpan bersama tautan.

generateQR

boolean

Sekalian kembalikan kode QR untuk URL pendeknya.

Contoh permintaan

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

Contoh respons

Panggilan yang berhasil mengembalikan 200 OK dengan URL pendek di 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"
  }
}

Batas laju dan error

10 req/minMaksimal 10 permintaan per menit per klien.
409Alias kustom itu sudah dipakai.
400URL tidak valid atau tanggal kedaluwarsa sudah lewat.
429Anda kena batas laju atau kuota bulanan Anda.