Zagl Logosu

API Dokümantasyonu

Linkleri doğrudan kodunuzdan kısaltın. Tek endpoint, tek bearer token.

Endpoint

POSThttps://za.gl/api/shorten
RESTJSON gövdeBearer auth

Kimlik doğrulama

API token'ınızı Authorization başlığında bearer token olarak gönderin. İlk linkinizi oluşturduktan sonra hesap panelinizden alabilirsiniz.

Header
Authorization: Bearer YOUR_API_TOKEN

Henüz token'ınız yok mu? Endpoint'i token olmadan da çağırabilirsiniz. Za.gl anında anonim bir hesap açar ve yeni token'ı şurada döner: data.newAuthToken. Linklerinizi sonra yönetmek için kaydedin.

İstek gövdesi

originalUrlzorunlu

string

Kısaltılacak uzun URL. Protokolü yazmazsanız https:// otomatik eklenir.

customAlias

string

Kendi seçtiğiniz uzantı, örn. za.gl/my-link. Benzersiz olmalı, yoksa 409 alırsınız.

password

string

Linki koruyun, ziyaretçiler devam etmek için parola girsin.

expiresAt

string (ISO date)

Linkin çalışmayı bırakacağı an. Gelecekte bir tarih olmalı.

expiresInMinutes / expiresInHours / expiresInDays

number

expiresAt yerine kullanılır, belirli bir süre sonra sona erdirir.

waitTimer

number (0-300)

Yönlendirmeden önce ziyaretçinin önizleme sayfasında bekleyeceği saniye.

customGtmId

string

Önizleme sayfasında tetiklenen kendi Google Tag Manager kimliğiniz (GTM-XXXXXXX).

title / description

string

Linkle birlikte saklanan isteğe bağlı metadata.

generateQR

boolean

Kısa URL için QR kod da döndürür.

Örnek istek

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

Örnek yanıt

Başarılı bir çağrı 200 OK döner, kısa URL şurada gelir: 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"
  }
}

İstek limitleri ve hatalar

10 req/minİstemci başına dakikada en fazla 10 istek.
409Bu takma ad zaten alınmış.
400Geçersiz URL veya geçmişte kalan bir son kullanma tarihi.
429İstek limitine veya aylık kotanıza takıldınız.