آدرس کلی درخواستها (Base URL)
تمام درخواستهای شما باید با این آدرس پایه شروع شوند. اندپوینتها و پارامترها در ادامه به این آدرس اضافه میشوند:
https://api.bighanoonabad.com/stats.phpاندپوینتها (Endpoints)
دریافت آمار یک بازیکن
این اندپوینت اطلاعات کامل یک بازیکن خاص را بر اساس نام کاربری او برمیگرداند.
GET
/stats.php?user={username}
دادههای ورودی (Request Parameters)
| پارامتر | نوع | توضیحات |
|---|---|---|
| user | string | (الزامی) نام کاربری بازیکن در ماینکرفت. |
نمونه درخواست کامل
https://api.bighanoonabad.com/stats.php?user=Notchدادههای پاسخ دریافتی (Response Fields)
| فیلد | نوع | توضیحات کامل |
|---|---|---|
| uuid | string | کد شناسایی منحصر به فرد و جهانی بازیکن (مانند کد ملی). |
| username | string | آخرین نام کاربری بازیکن که در سرور ثبت شده است. |
| statistics.total_kills | integer | یک عدد صحیح که تعداد کل بازیکنانی که کشته است را نشان میدهد. |
| statistics.playtime_seconds | integer | مجموع کل زمان بازی بازیکن به واحد ثانیه. این مقدار خام برای محاسبات مناسب است. |
| statistics.playtime_formatted | string | همان زمان بازی است که برای خوانایی بهتر به فرمت "روز، ساعت، دقیقه و ثانیه" تبدیل شده است. |
نمونه پاسخ دریافتی
{
"error": false,
"data": {
"uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
"username": "Notch",
"statistics": {
"total_kills": 150,
"playtime_seconds": 97815,
"playtime_formatted": "1d 3h 10m 15s"
}
}
}دریافت جدول ردهبندی (Leaderboard)
برای ساختن جدول ردهبندی بازیکنان بر اساس کیل یا زمان بازی از این اندپوینت استفاده کنید.
GET
/stats.php?leaderboard={type}دادههای ورودی (Request Parameters)
| پارامتر | نوع | توضیحات |
|---|---|---|
| leaderboard | string | (الزامی) نوع جدول. مقادیر مجاز: kills یا playtime. |
| limit | integer | (اختیاری) تعداد بازیکنان. پیشفرض: 10. |
| order | string | (اختیاری) ترتیب نمایش. مقادیر مجاز: asc یا desc. پیشفرض: desc. |
نمونه درخواست کامل
https://api.bighanoonabad.com/stats.php?leaderboard=kills&limit=3دادههای پاسخ دریافتی (Response Fields)
| فیلد | نوع | توضیحات کامل |
|---|---|---|
| leaderboard_type | string | نوع لیدربرد درخواستی را مشخص میکند (kills یا playtime). |
| count | integer | تعداد بازیکنانی که در لیست نتایج بازگردانده شدهاند. |
| results | array | یک لیست (آرایه) از بازیکنان برتر. هر آیتم در این لیست یک آبجکت بازیکن است. |
| results[].statistic | mixed | مقدار آماری که برای نمایش به کاربر مناسب است. برای پلیتایم، این مقدار فرمت شده است. |
| results[].raw_value | integer | مقدار خام و عددی آمار. برای کیل، واحد آن تعداد کیل و برای پلیتایم، واحد آن ثانیه است. |
نمونه پاسخ دریافتی
{
"error": false,
"data": {
"leaderboard_type": "kills",
"count": 3,
"results": [
{
"username": "Player1",
"statistic": 250,
"raw_value": 250
},
{
"username": "Notch",
"statistic": 150,
"raw_value": 150
},
{
"username": "Player3",
"statistic": 125,
"raw_value": 125
}
]
}
}