শুরু করা
পরিচিতি
Orlabia Tech-র প্রতিটি এন্ডপয়েন্ট একইভাবে কাজ করে: একটি HTTPS রিকোয়েস্ট, একটি Bearer টোকেন, একটিই JSON ফরম্যাট। পাঁচ মিনিটের মধ্যেই আপনি চালু করে ফেলতে পারবেন।
Orlabia Tech ব্যবহারের 3টি ধাপ
API কি তৈরি করুন
সাইন আপ করে Dashboard → API Keys থেকে একটি কি তৈরি করুন। সাইন আপ করতে কার্ড লাগে না।
রিকোয়েস্ট পাঠান
Authorization হেডারে আপনার কি দিয়ে HTTPS-এ যেকোনো এন্ডপয়েন্টে কল করুন।
রেসপন্স সামলান
প্রতিটি রেসপন্সে একই { success, data, error } ফরম্যাট — একটি হ্যান্ডলারেই সব হয়ে যায়।
Dashboard → API Keys পেজে আপনার API কি পাবেন। প্রতিটি রিকোয়েস্টে সেটি এভাবে পাঠান: Authorization: Bearer <key>.
বেস URL
রিকোয়েস্টের উদাহরণ
GET এন্ডপয়েন্টে প্যারামিটার যায় কোয়েরি স্ট্রিংয়ে, আর POST এন্ডপয়েন্টে JSON বডিতে:
curl "https://preview-api.orlabia.com/v1/taobao/item_detail?item_id=675432198765¤cy=USD" \
-H "Authorization: Bearer YOUR_API_KEY"রেসপন্স ফরম্যাট
সফল হোক বা ফেইল, প্রতিটি এন্ডপয়েন্ট একই ফরম্যাটে উত্তর দেয় — তাই একটি হ্যান্ডলারেই আপনার পুরো ইন্টিগ্রেশন চলে যায়:
{
"success": true,
"data": { "...": "payload, null on error" },
"error": null
}স্ট্যাটাস কোড
| কোড | অর্থ |
|---|---|
| 200 | ঠিক আছে — রিকোয়েস্ট সফল, ক্রেডিট কাটা হয়েছে |
| 400 | ভুল রিকোয়েস্ট — প্যারামিটার নেই বা ঠিক নেই, চার্জ কাটা হয়নি |
| 401 | অনুমতি নেই — API কি নেই বা বাতিল করা হয়েছে |
| 404 | পাওয়া যায়নি — আইটেম বা শপটি নেই, চার্জ কাটা হয়নি |
| 429 | রেট লিমিট — Retry-After হেডারে বলা সময় পরে আবার চেষ্টা করুন |
| 500 | আপস্ট্রিম এরর — আবার চেষ্টা করা নিরাপদ, চার্জ কাটা হয়নি |
রেট লিমিট ও আবার চেষ্টা
লিমিট আপনার প্ল্যান অনুযায়ী বাড়ে (ফ্রিতে সেকেন্ডে 1 রিকোয়েস্ট → এন্টারপ্রাইজে আপনার নিজের মাপে)। 429 রেসপন্স পেলে Retry-After হেডারে বলা সময়টুকু অপেক্ষা করে তারপর আবার চেষ্টা করুন। রেট লিমিটে আটকানো আর ফেইল হওয়া রিকোয়েস্টের কোনো চার্জ কাটা হয় না, তাই exponential-backoff দিয়ে বারবার চেষ্টা করা সবসময়ই নিরাপদ।