در این بخش، 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 آدرس یا دامنه (در صورت وجود) نیز استفاده شود. |
اگر IP یا دامنه به عنوان serverName وارد شود، اطلاعات مربوط به آن سرور بازگردانده خواهد شد.
این جدول مقادیر برگشتی سرور ها را با نوع هر مقدار و توضیحات مربوط به آن نمایش میدهد.
در صورت داشتن
?در کنار نوع داده، این مقدار ممکن است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 | سطح دستاورد |