কে এটি ব্যবহার করতে পারে?
যেসব লিগ “স্বর্ণ” (Gold) পরিকল্পনায় আছে এবং এপিআই চালু করেছে। এটি চালু করতে অ্যাডমিন হোম > API > API সেটিংস-এ যান এবং JSON API চালু করুন-এ টিক দিন। এর কোনো একটি না থাকলে, এই নিবন্ধগুলোর প্রতিটি ওয়েব ঠিকানা আপনার ডেটার বদলে একটি ত্রুটি দেখাবে।
এটি কী?
এপিআই অন্য কোনো ওয়েবসাইট, অ্যাপ বা প্রোগ্রামকে সরাসরি LeagueRepublic থেকে আপনার লিগের ম্যাচ, ফলাফল ও পয়েন্ট টেবিল পড়তে দেয়। একে একজন ওয়েটারের মতো ভাবুন: আপনার ওয়েবসাইট কিছু চায় ("আজকের ম্যাচগুলো, প্লিজ"), আর LeagueRepublic উত্তরটি এনে দেয়।
কীভাবে চাইবেন?
আপনি একটি ওয়েব ঠিকানায় যান, ঠিক যেমন একটি ওয়েব পেজ খোলেন। সুন্দর দেখতে একটি পেজের বদলে আপনি JSON নামের একটি ফরম্যাটে সাধারণ লেখা ফেরত পান। আপনার ওয়েব ডেভেলপারের কোড, অথবা কোনো এআই সহকারীর তৈরি পেজ, সেই লেখা পড়ে এবং আপনি যেভাবে ডিজাইন করেন সেভাবে সাজিয়ে দেখায়।
JSON দেখতে কেমন?
এটি লেবেল ও মানের একটি তালিকা, অনেকটা পূরণ করা একটি ফর্মের মতো:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
কোলনের আগের শব্দটি হলো ফিল্ডের নাম (ফর্মের লেবেল)। এর পরের অংশটি হলো মান (ঘরে যা লেখা হয়েছে)। প্রতিটি ফিল্ডের নামের অর্থ এপিআই স্পেসিফিকেশনে ব্যাখ্যা করা আছে।
আইডি কী?
LeagueRepublic-এ প্রতিটি লিগ, সিজন, ডিভিশন, দল ও ম্যাচের নিজস্ব একটি নম্বর আছে, যাকে আইডি বলে। এটি সদস্যপদ নম্বরের মতো কাজ করে: এটি কখনো বদলায় না, আর দুটি জিনিসের একই নম্বর থাকে না। কোন সিজন বা কোন দল চান তা বোঝাতে আপনি ওয়েব ঠিকানায় আইডি বসান।
আমি আমার আইডিগুলো কীভাবে খুঁজে পাব?
আপনার লিগ আইডি দেখানো হয় অ্যাডমিন হোম > API > API সেটিংস-এ।
আপনার সিজন আইডি: আপনার ব্রাউজারে এই ঠিকানাটি খুলুন, [আমার-লিগ-আইডি]-এর জায়গায় আপনার লিগ আইডি বসিয়ে। এটি আপনার সিজনগুলোর তালিকা দেখাবে, প্রতিটির সাথে তার আইডি।
https://api.leaguerepublic.com/json/getSeasonsForLeague/[আমার-লিগ-আইডি].json
ডিভিশন ও দলের আইডি এপিআই যে তালিকাগুলো ফেরত পাঠায় সেগুলোতে থাকে। আপনি যদি তৈরি করুন… নিবন্ধগুলোর কোনো একটি ব্যবহার করেন, তাহলে এআই সহকারী আপনার জন্য এগুলো খুঁজে নেবে।
কোনো সীমা আছে কি?
হ্যাঁ। প্রতিটি লিগ প্রতি মিনিটে কেবল নির্দিষ্ট সংখ্যক অনুরোধ পাঠাতে পারে, আর আপনার লিগের ডেটা ব্যবহার করে এমন সবকিছু মিলে সেটি ভাগ করে নেয়: আপনার ওয়েবসাইট, অ্যাপ এবং অন্য যেকোনো কিছু। একটি ভালোভাবে তৈরি পেজ বারবার না চেয়ে যা লোড করে তা সংরক্ষণ করে রাখে। সঠিক সীমা এপিআই স্পেসিফিকেশনে দেওয়া আছে।
কয়েকটি শব্দ যা আপনি দেখবেন
Road – অতিথি দল। বেশিরভাগ মানুষ যেখানে "অ্যাওয়ে" বলেন, LeagueRepublic সেখানে "road" বলে।
Fixture – একটি ম্যাচ, সেটি খেলা হয়ে থাকুক বা না থাকুক।
Fixture group – একটি ডিভিশন (যেমন "Premier Division"), একটি কাপ, অথবা ম্যাচের অন্য কোনো গ্রুপ।
Result – এমন একটি ম্যাচ যার স্কোর আছে।
null – ঘরটি খালি। লিগ এটি পূরণ করেনি, অথবা এটি প্রযোজ্য নয়।
true / false – হ্যাঁ / না।
সম্পূর্ণ বিবরণ কোথায়?
সব সুনির্দিষ্ট তথ্য, যেমন প্রতিটি ফিল্ডের নাম, সীমা এবং ত্রুটির বার্তা, এপিআই স্পেসিফিকেশনে আছে: