API ডকুমেন্টেশন
কোড থেকেই সরাসরি লিংক ছোট করুন। একটি এন্ডপয়েন্ট, একটি বেয়ারার টোকেন।
এন্ডপয়েন্ট
https://za.gl/api/shortenঅথেনটিকেশন
আপনার API টোকেন পাঠান Authorization হেডারে, বেয়ারার টোকেন হিসেবে। প্রথম লিংক তৈরির পরে অ্যাকাউন্ট ড্যাশবোর্ড থেকে এটা নিন।
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 কোডও ফেরত দিন। |
originalUrlআবশ্যকstring
যে লম্বা URL ছোট করবেন। প্রোটোকল না দিলে https:// নিজে থেকেই যোগ হয়।
customAliasstring
আপনার নিজের শেষাংশ, যেমন za.gl/my-link। এটা ইউনিক হতে হবে, নাহলে 409 পাবেন।
passwordstring
লিংকটি সুরক্ষিত করুন, যাতে ভিজিটরকে এগোতে পাসওয়ার্ড দিতে হয়।
expiresAtstring (ISO date)
লিংকটি কখন বন্ধ হবে। সময়টা ভবিষ্যতের হতে হবে।
expiresInMinutes / expiresInHours / expiresInDaysnumber
expiresAt-এর বিকল্প, একটি নির্দিষ্ট সময় পার হলে মেয়াদ শেষ।
waitTimernumber (0-300)
রিডাইরেক্টের আগে ভিজিটর প্রিভিউ পেজে যত সেকেন্ড অপেক্ষা করবে।
customGtmIdstring
আপনার নিজের Google Tag Manager ID (GTM-XXXXXXX), প্রিভিউ পেজে চালু হয়।
title / descriptionstring
লিংকের সঙ্গে রাখা ঐচ্ছিক মেটাডেটা।
generateQRboolean
শর্ট URL-এর জন্য একটি QR কোডও ফেরত দিন।
উদাহরণ রিকোয়েস্ট
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.
{
"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আপনি রেট লিমিট বা মাসিক কোটা ছাড়িয়ে গেছেন।