অথেন্টিকেশন ও অ্যাকাউন্ট এন্ডপয়েন্ট

প্রতিটি রিকোয়েস্টে একটি হেডার থাকে। GET /account কল করে আপনি দেখে নিতে পারেন API key ঠিকমতো কাজ করছে কি না, অর্ডারের টাকা যে ওয়ালেট থেকে কাটা হয় তার ব্যালেন্স কত, আর ব্যাচ রান শুরুর আগে অ্যাকাউন্ট চালু আছে কি না।

রিকোয়েস্ট যেভাবে অথেন্টিকেট হয়

Authorization হেডারে একটি Bearer ক্রেডেনশিয়াল পাঠাতে হয়, যার গঠন হলো একটি কী আইডি আর একটি সিক্রেট, মাঝখানে একটি ডট দিয়ে জোড়া। কী আইডি দিয়ে অ্যাকাউন্ট চেনা হয়, আর সিক্রেটটি HMAC তুলনার মাধ্যমে যাচাই করা হয়। যাচাই ব্যর্থ হলে রুটটি চালু হওয়ার আগেই 401 ফেরত আসে, সঙ্গে MISSING_API_KEY অথবা INVALID_API_KEY কোড। এর বাইরে কুকি, CSRF টোকেন বা Origin হেডার, কোনো কিছুই পরীক্ষা করা হয় না।

IP অ্যালাউলিস্ট

একটি key নির্দিষ্ট সোর্স ঠিকানার একটি তালিকায় বেঁধে রাখা যায়। এই তালিকায় কিছু থাকলে অন্য যেকোনো ঠিকানার রিকোয়েস্ট IP_NOT_ALLOWED ও HTTP 403 দিয়ে ফিরিয়ে দেওয়া হয়। যাচাইটি রেট লিমিট আর ওয়ালেট লুকআপের আগেই হয়, তাই চুরি যাওয়া ক্রেডেনশিয়াল আপনার নিজের ইনফ্রাস্ট্রাকচারের বাইরে কাজে লাগানো যায় না। তালিকা খালি থাকলে key যেকোনো জায়গা থেকে কাজ করে।

অ্যাকাউন্টের অবস্থা

অ্যাকাউন্ট পর্যায়ের একটি অবস্থা সব এন্ডপয়েন্টকে শুরুতেই থামিয়ে দেয়: ফ্রোজেন অ্যাকাউন্ট HTTP 403 সহ ACCOUNT_FROZEN ফেরত দেয়। এটি নিজে থেকে ঠিক হয় না, তাই লুপে বারবার রিট্রাই না করে বিষয়টি একজন মানুষের নজরে আনুন।

API key রোটেশন

রিসেলার প্যানেলের API Access পেজ থেকে key তৈরি ও ডিলিট করা হয়। তৈরির সময় secret একবারই দেখানো হয়, তাই রোটেশন মানে আগের key এডিট করা নয়: নতুন key তৈরি, ডিপ্লয়, তারপর পুরোনোটি ডিলিট। ক্রেডেনশিয়ালের মেয়াদ নিজে থেকে শেষ হয় না, তাই কখন রোটেট করবেন তা আপনিই ঠিক করবেন।

GET

/account

অ্যাকাউন্টের তথ্য দেখুন

ওয়ালেট ব্যালেন্স, অ্যাকাউন্টের স্ট্যাটাস ও তৈরির তারিখসহ অ্যাকাউন্টের বিস্তারিত তথ্য নিন।

রেট লিমিটপ্রতি অ্যাকাউন্টে 60 সেকেন্ডে 60 রিকোয়েস্ট

রিকোয়েস্ট

curl -s "https://shop2topup.com/api/endpoints/v1/account" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

রেসপন্সের উদাহরণ

{
  "success": true,
  "account": {
    "id": 42,
    "email": "[email protected]",
    "username": "partner_store",
    "client_type": "reseller",
    "wallet": "1250.500000",
    "enabled": true,
    "verified": true,
    "created_at": "2024-01-15T10:30:00Z"
  }
}

এই পেজ থেকেই আসল রিকোয়েস্ট পাঠান

এই এন্ডপয়েন্টগুলো লাইভ কল করতে একটি API key পেস্ট করুন। key এই ব্রাউজার ট্যাবেই থাকে এবং শুধু API-তেই পাঠানো হয়।

Enter your API key to use the interactive playground. Get your API key

এন্ডপয়েন্ট বেছে নিন

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

প্ল্যাটফর্মে নতুন হলে রিসেলারদের জন্য গেম টপ আপ API ওভারভিউ, অথবা SHOP2TOPUP রিসেলার প্রোগ্রামের পরিচিতি পড়ে জেনে নিন পার্টনার অ্যাকাউন্ট কীভাবে কাজ করে।