অথেন্টিকেশন
API-তে প্রতিটি রিকোয়েস্টে একটি API কী থাকে। রিকোয়েস্ট কখনো ব্রাউজার সেশনের সঙ্গে মেলানো হয় না।
API কী তৈরি করা
আপনার অ্যাকাউন্টে API কী অংশে API কী তৈরি করুন, সর্বোচ্চ 5টি। সাইন ইন থাকা অবস্থায় যেকোনো সময় ওই পেজ থেকে API কী কপি করতে পারবেন: আমরা এটি এনক্রিপ্ট করে রাখি, এবং শুধু আপনাকেই দেখাই। পাসওয়ার্ডের মতো এটি গোপন রাখুন, এবং কেউ দেখে থাকতে পারে মনে হলে সেটি বাতিল করে আরেকটি তৈরি করুন।
API কী পাঠানো
এটি Authorization হেডারে Bearer-এর পরে API কী লিখে পাঠান। X-API-Key-ও কাজ করে।
curl "https://api.talismanleads.io/v1/account" \
-H "Authorization: Bearer tl_live_your_key_here"API কী দিয়ে যা করা যায়
নতুন API কী সবকিছু করতে পারে: আপনার ব্যালেন্স, চেকার, আপনার অর্ডার ও সেগুলোর ফলাফল দেখতে পারে, এবং POST /uploads, POST /estimates ও POST /orders ব্যবহার করতে পারে, যেগুলো আপনার লিস্ট সংরক্ষণ করে বা আপনার ব্যালেন্স খরচ করে। 8 নভেম্বর 2026-এর আগে তৈরি API কী রিড-অনলি হতে পারে: এটি সবকিছু দেখতে পারে, কিন্তু ওই তিনটি কল missing_scope সহ এটিকে প্রত্যাখ্যান করে।
মেয়াদ ও IP ঠিকানা
নতুন API কী-এর মেয়াদ কখনো শেষ হয় না এবং এটি যেকোনো ঠিকানা থেকে কাজ করে। 8 নভেম্বর 2026-এর আগে তৈরি API কী-এর মেয়াদ শেষের একটি তারিখ থাকতে পারে, যার পরে এটি expired_key সহ প্রত্যাখ্যান করা হয়, অথবা এটি আপনার সার্ভারের IP ঠিকানাগুলোতে সীমিত থাকতে পারে, ফলে অন্য কোথাও থেকে আসা রিকোয়েস্ট ip_not_allowed সহ প্রত্যাখ্যান করা হয়। এর কোনোটি বদলাতে, নতুন API কী তৈরি করুন এবং পুরোনোটি বাতিল করুন।
API কী নিরাপদে রাখা
- API কী-কে পাসওয়ার্ডের মতো রাখুন: এটি যার কাছে আছে সে আপনার ব্যালেন্স খরচ করতে পারে।
- এটি শুধু আপনার সার্ভারে ব্যবহার করুন। API ওয়েব পেজ থেকে কল করার অনুমতি দেয় না।
- এটি আপনার কোড ও ভার্সন কন্ট্রোলের বাইরে রাখুন।
- API কী কেউ দেখে থাকতে পারে মনে হলে, সঙ্গে সঙ্গে আপনার অ্যাকাউন্টে সেটি বাতিল করুন। এটি তখনই কাজ করা বন্ধ করে। আগে দেওয়া অর্ডার চলতে থাকে।
- এটি শুধু API-তে পাঠান। আপলোড ও ডাউনলোড লিংকের নিজস্ব অনুমতি থাকে, তাই সেগুলোতে আপনার API কী পাঠাবেন না।
API কী প্রত্যাখ্যাত হলে
ভুল, বাতিল করা বা মেয়াদোত্তীর্ণ API কী-তে 401 আসে। ব্লক করা API কী বা অ্যাকাউন্টে 403 আসে। দেখুন এরর।