📂سرور

در این بخش، APIهای مختلفی برای دریافت اطلاعات سرورها بر اساس دسته‌بندی و نام آنها ارائه شده است. با استفاده از این API ها می‌توانید به لیست کامل سرورها، سرورهای یک دسته‌بندی خاص، و یا اطلاعات یک سرور خاص دسترسی داشته باشید.

---

این endpoint لیست تمامی سرورهای ثبت ‌شده در گیم تولز را برمی‌گرداند.

پارامتر	نوع داده	توضیحات
-	-	هیچ پارامتری لازم نیست. این endpoint تمام سرورها را به صورت یک لیست برمی‌گرداند.

این endpoint لیست تمامی سرورهای ثبت ‌شده در هر بخش گیم تولز را برمی‌گرداند.

پارامتر	نوع داده	توضیحات
category	string	دسته‌بندی سرور مورد نظر؛ مانند mc برای Minecraft، fivem برای FiveM، و mta برای MTA.

این endpoint لیست مشخصات هر سرور ثبت شده در گیم تولز را برمی‌گرداند.

پارامتر	نوع داده	توضیحات
category	string	دسته‌بندی سرور مورد نظر؛ مانند mc برای Minecraft، fivem برای FiveM، و mta برای MTA.
serverName	string	نام سرور مورد نظر که می‌تواند به عنوان serverName شناخته شود. همچنین می‌تواند به عنوان IP آدرس یا دامنه (در صورت وجود) نیز استفاده شود.

---

این جدول مقادیر برگشتی سرور ها را با نوع هر مقدار و توضیحات مربوط به آن نمایش می‌دهد.

در صورت داشتن ? در کنار نوع داده، این مقدار ممکن است null باشد.

کلید	نوع	توضیحات
id	number	شناسه منحصر به فرد سرور
name	string	نام سرور
description	string?	توضیحات مربوط به سرور
category	string	دسته‌بندی سرور
address	string	آدرس سرور
ip	string	آدرس IP سرور
location	string?	موقعیت سرور (فقط در صورت آنلاین بودن)
uptime	number?	زمان آنلاین بودن سرور (فقط در صورت آنلاین بودن)
downtime	number?	زمان عدم آنلاین بودن سرور (فقط در صورت غیر آنلاین بودن)
trackedAt	string	تاریخ و زمان آخرین به‌روزرسانی اطلاعات سرور
version	string?	نسخه سرور (فقط برای دسته‌بندی mc)
color	string	رنگ مربوط به سرور
logo	string	URL لوگوی سرور
banner	string?	URL بنر سرور
splashBanner	string?	URL بنر Splash سرور
motd	string?	پیام روز (فقط برای دسته‌بندی mc و در صورت آنلاین بودن)
isOnline	boolean	وضعیت آنلاین بودن سرور
isVerify	boolean	وضعیت تأیید شده بودن سرور
port	number	پورت سرور
ping	number	زمان پینگ سرور
maxPlayers	number?	حداکثر تعداد بازیکنان (فقط در صورت آنلاین بودن)
topPlayers	number	رکورد بیشترین بازیکن انلاین
players	number	تعداد بازیکنان انلاین
rating	number	امتیاز سرور بر اساس نظرات کاربران
boosts	number	تعداد بوست‌های فعال برای سرور
likes	number	تعداد لایک‌ها سرور
votes	number	تعداد رای‌ها سرور
social	object	اطلاعات شبکه‌های اجتماعی مرتبط با سرور
tags	array?	برچسب‌های مربوط به سرور (فقط برای دسته‌بندی fivem)
gamemodes	array?	لیست گیم‌مودهای سرور (فقط برای دسته‌بندی mc)
badges	array	نشان‌های مربوط به سرور
achievements	array	دستاوردهای مربوط به سرور

این بخش شامل لینک‌های مربوط به شبکه‌های اجتماعی سرور است. با استفاده از این اطلاعات، می‌توانید به راحتی به کانال‌های ارتباطی و اطلاعات بیشتر درباره سرور دسترسی پیدا کنید.

کلید	نوع	توضیحات
discord	string?	لینک سرور دیسکورد
telegram	string?	لینک کانال تلگرام
instagram	string?	لینک پروفایل اینستاگرام
website	string?	لینک وب‌سایت سرور
teamspeak	string?	لینک سرور تیم اسپیک

این بخش شامل برچسب‌های مربوط به سرور است که می‌تواند به شناسایی و دسته‌بندی سرور کمک کند. هر برچسب به صورت یک رشته نمایان می‌شود.

کلید	نوع	توضیحات
item	string	هر برچسب به صورت یک رشته (string)

این بخش شامل لیستی از گیم‌مودهای موجود در سرور است. هر گیم‌مود با نام و تعداد بازیکنان حاضر در آن مشخص می‌شود.

کلید	نوع	توضیحات
name	string	نام گیم‌مود
players	number	تعداد بازیکنان حاضر در آن گیم‌مود

این بخش شامل نشان‌های مربوط به سرور است. هر نشان شامل توضیحاتی درباره ویژگی‌ها و امتیازات مربوط به سرور می‌باشد.

کلید	نوع	توضیحات
item	string	توضیحات نشان

این بخش شامل دستاوردهایی است که کسب کرده است. هر دستاورد با تاریخ دریافت، نوع و سطح آن مشخص می‌شود.

کلید	نوع	توضیحات
receivedAt	string	تاریخ دریافت دستاورد
type	string	نوع دستاورد (boost,vote,player,like)
level	number	سطح دستاورد