প্লেয়ার যাচাইয়ের এন্ডপয়েন্ট

কোনো টাকা লেনদেন হওয়ার আগেই প্লেয়ার যাচাই গেমের অ্যাকাউন্টটি খুঁজে বের করে। ওই প্রোডাক্টের জন্য আইডিটি আসলেই আছে কি না তা নিশ্চিত করে, আর ইন-গেম নাম ফেরত দেয় যাতে আপনার ক্রেতা মিলিয়ে দেখতে পারেন। সাথে রিজিয়নও জানিয়ে দেয়, ফলে অন্য রিজিয়নের অর্ডার পেমেন্টের পরে ব্যর্থ না হয়ে শুরুতেই বাতিল হয়।

কোন ফিল্ডগুলো পাঠাবেন

প্রতিটি রিকোয়েস্ট বডিতে দুটি নির্দিষ্ট ফিল্ড সবসময় থাকে, আর তার সঙ্গে যোগ হয় গেমটি নিজে যেসব তথ্য চায় সেগুলো, যা গেমভেদে আলাদা হতে পারে। কোন কোন ফিল্ড লাগবে তা জানতে সবার আগে GET /catalog/category/:categoryId/requirements কল করে তালিকাটি দেখে নিন। এরপর সেই রেসপন্সে আসা প্রতিটি field_name-এর জন্য মান পাঠান, আর সঙ্গে দিন sub_category_id ও player_id। যেসব ফিল্ডের ধরন single_select (একটি মান বাছাই) বা multi_select (একাধিক মান বাছাই), সেগুলোতে শুধু ওই ফিল্ডের নিজস্ব select_options তালিকার মানই চলে, এর বাইরের কোনো মান গ্রহণ করা হয় না। কোনো দরকারি ফিল্ড বাদ পড়লে রিকোয়েস্টটি ফিরিয়ে দেওয়া হয় MISSING_REQUIRED_FIELD (দরকারি ফিল্ড অনুপস্থিত) কোড দিয়ে। আর কোনো মান যদি ফিল্ডের নিয়ম না মানে, তাহলে ফেরত আসে INVALID_PARAMETER_FORMAT (ফরম্যাট ঠিক নেই), INVALID_PARAMETER_VALUE (মান গ্রহণযোগ্য নয়) অথবা INVALID_PARAMETER_LENGTH (দৈর্ঘ্য ঠিক নেই)। দুই ক্ষেত্রেই রেসপন্সের details.field দেখে বোঝা যাবে ঠিক কোন ফিল্ডে সমস্যা হয়েছে।

সফল রেসপন্সে ওই আইডির ইন-গেম নাম আর রিজিয়ন ফেরত আসে। যে প্রোডাক্টটি বিক্রি করতে যাচ্ছেন, তার সঙ্গে এই রিজিয়ন মিলিয়ে নিন। না মিললে REGION_MISMATCH দিয়ে প্রত্যাখ্যান করা হয়। ভ্যালিডেশনের সময় এটা ধরতে পারলে খরচ মাত্র একটি রিকোয়েস্ট, কিন্তু অর্ডারের সময় ধরা পড়লে পুরো একটা রিফান্ড প্রক্রিয়া পার হতে হয়।

POST

/player/validate

প্লেয়ার যাচাই করুন

নির্দিষ্ট গেমের জন্য Player ID যাচাই করুন। ক্যাটাগরির রিকোয়ারমেন্ট এন্ডপয়েন্ট থেকে পাওয়া ডাইনামিক ফিল্ডগুলোও রিকোয়েস্টে দিন।

রেট লিমিটআপনার দৈনিক প্লেয়ার চেক কোটা (প্রতি অ্যাকাউন্টে); X-RateLimit হেডার থাকে না

নোট: কোন গেমে কোন ফিল্ড লাগবে, তা ক্যাটাগরির রিকোয়ারমেন্ট এন্ডপয়েন্ট থেকে জেনে নিন। প্রয়োজনীয় সব ফিল্ড রিকোয়েস্ট বডিতে দিন। PLAYER_NOT_FOUND মানে গেম নিশ্চিত করেছে যে এই ID নেই; PLAYER_CHECK_UNAVAILABLE (HTTP 503, আবার চেষ্টা করা যাবে) মানে এই মুহূর্তে ID যাচাই করা যায়নি, তবে ID বাতিলও করা হয়নি।

রিকোয়েস্ট বডি

নাম	ধরন	আবশ্যক	বিবরণ	উদাহরণ
sub_category_id	number	হ্যাঁ	প্রোডাক্টের সাবক্যাটাগরি ID। এটি খুঁজে পেতে Catalog Explorer ব্যবহার করুন।	999
player_id	string	হ্যাঁ	গেমের ভেতরের Player ID।	123456789
...requirements	varies	না	ক্যাটাগরির রিকোয়ারমেন্ট এন্ডপয়েন্টের অতিরিক্ত ফিল্ড। প্রতিটি field_name-কে key হিসেবে আর ইউজারের দেওয়া মানকে তার value হিসেবে দিন।	"server": "Asia"

রিকোয়েস্ট

curl -s -X POST "https://shop2topup.com/api/endpoints/v1/player/validate" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "sub_category_id": 999,
  "player_id": 123456789
}'

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

{
  "success": true,
  "player": {
    "player_id": "123456789",
    "player_name": "ProGamer99",
    "region": "Asia"
  }
}

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

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

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

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

sub_category_id *

Use Catalog Explorer to find this

No requirements for this category.

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

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