Zagl लोगो

API डॉक्युमेंटेशन

अपने कोड से सीधे लिंक छोटे करें। एक एंडपॉइंट, एक bearer टोकन।

एंडपॉइंट

POSThttps://za.gl/api/shorten
RESTJSON बॉडीBearer ऑथ

ऑथेंटिकेशन

अपना API टोकन Authorization हेडर में bearer टोकन के तौर पर भेजें। पहला लिंक बनाने के बाद इसे अपने अकाउंट डैशबोर्ड से लें।

हेडर
Authorization: Bearer YOUR_API_TOKEN

अभी टोकन नहीं है? आप बिना टोकन के भी एंडपॉइंट कॉल कर सकते हैं। Za.gl तुरंत एक एनॉनिमस अकाउंट बना देता है और नया टोकन data.newAuthToken. में लौटाता है। बाद में अपने लिंक मैनेज करने के लिए इसे सेव कर लें।

रिक्वेस्ट बॉडी

originalUrlज़रूरी

string

जिस लंबे URL को छोटा करना है। प्रोटोकॉल न लिखें तो https:// अपने आप जुड़ जाता है।

customAlias

string

लिंक का आपका अपना हिस्सा, जैसे za.gl/my-link। यह यूनीक होना चाहिए, वरना 409 मिलता है।

password

string

लिंक को सुरक्षित करें ताकि आगे बढ़ने के लिए विज़िटर को पासवर्ड डालना पड़े।

expiresAt

string (ISO date)

लिंक कब काम करना बंद करे। तारीख भविष्य की होनी चाहिए।

expiresInMinutes / expiresInHours / expiresInDays

number

expiresAt का विकल्प, तय समय बीतने के बाद एक्सपायर करें।

waitTimer

number (0-300)

रीडायरेक्ट से पहले विज़िटर प्रीव्यू पेज पर कितने सेकंड रुके।

customGtmId

string

आपकी अपनी Google Tag Manager ID (GTM-XXXXXXX), जो प्रीव्यू पेज पर चलती है।

title / description

string

लिंक के साथ सेव होने वाला वैकल्पिक मेटाडेटा।

generateQR

boolean

शॉर्ट URL के लिए QR कोड भी लौटाएँ।

उदाहरण रिक्वेस्ट

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

उदाहरण रिस्पॉन्स

सफल कॉल पर मिलता है 200 OK और शॉर्ट URL यहाँ मिलता है 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"
  }
}

रेट लिमिट और एरर

10 req/minहर क्लाइंट के लिए ज़्यादा से ज़्यादा 10 रिक्वेस्ट प्रति मिनट।
409यह कस्टम एलियास पहले से लिया जा चुका है।
400गलत URL या बीत चुकी एक्सपायरी तारीख।
429आपने रेट लिमिट या महीने का कोटा पार कर लिया।