MCStat
MCSTAT
REST API

وثائق واجهة برمجة التطبيقات

قم بدمج بيانات خادم Minecraft المباشرة والمشغل والسطح والمجتمع من mcstat.org في التطبيقات والروبوتات ولوحات المعلومات الخاصة بك.

عنوان URL الأساسي

تبدأ جميع طلبات واجهة برمجة التطبيقات بعنوان URL الأساسي هذا

https://mcstat.org/api/v1
عرض كـ Markdown

وثائق Markdown خام للذكاء الاصطناعي والروبوتات والأدوات

مفاتيح واجهة برمجة التطبيقات

إدارة ومراقبة مفاتيح API الخاصة بك

قم بإنشاء وتدوير وعرض التحليلات الخاصة بمفاتيح API الخاصة بك في لوحة المعلومات.

افتح لوحة معلومات مفتاح API

ملعب API

اختبار نقاط النهاية مباشرة في المتصفح

لا تتطلب هذه البيئة مفتاح API؛ التحقق البشري مطلوب للحد من الإساءة.

GET
/api/v1/servers
page
integer
limit
integer
sort
string
search
string
country
string
version
string
tag
string
mode
string
minPlayers
integer
maxPlayers
integer
minUptime
number
minVotes
integer
minRating
number
onlineOnly
boolean
https://mcstat.org/api/v1/servers
قم بتشغيل طلب لرؤية الرد

المصادقة

تتطلب جميع نقاط نهاية واجهة برمجة التطبيقات العامة الموثقة مفتاح واجهة برمجة التطبيقات. أرسل مفتاحك في رأس X-API-Key.

رأس الطلب

أضف هذا الرأس للمصادقة

X-API-Key: mcs_your_key_here

أو كمعلمة استعلام

أو تمرير كمعلمة الاستعلام

?api_key=mcs_your_key_here

حدود المعدل

تتم مصادقة الطلبات عن طريق مفتاح API. يؤدي المفتاح المفقود أو غير الصالح إلى إرجاع HTTP 401، بينما يقوم المفتاح المعطل بإرجاع HTTP 403، ويؤدي الحد الذي تم تجاوزه إلى إرجاع HTTP 429.

بدون مفتاح API

غير مسموح

مع مفتاح API

60 طلبًا في الدقيقة و1000 يوميًا و30000 شهريًا بشكل افتراضي. يؤدي تجاوز الحد إلى إرجاع HTTP 429 مع رؤوس X-RateLimit-* التي تعرض حدودك وإعادة المحاولة بعد إخبارك عند إعادة تعيين النافذة. يمكن منح حدود أعلى لكل مفتاح عند الطلب.

رؤوس حدود السعر:استجابة 429 تحمل X-RateLimit-Limit-Minute، وX-RateLimit-Limit-Day، وX-RateLimit-Remaining-Day، وX-RateLimit-Limit-Month، وX-RateLimit-Remaining-Month، وإعادة المحاولة بعد ذلك. تحمل الاستجابات الناجحة رأس التحكم في ذاكرة التخزين المؤقت حتى تتمكن من تخزين النتائج من جانب العميل بأمان.

تنسيق الاستجابة

كل استجابة ناجحة هي JSON مع كائن منطقي وكائن . تستخدم الأخطاء نفس المغلف مع : false.

استجابة النجاح

JSON
{
  "success": true,
  "data": {
    "resource": {
      "id": "...",
      "name": "Example"
    }
  }
}

استجابة الخطأ

JSON
{
  "success": false,
  "error": "Too many requests"
}

أخطاء

يتم استخدام رموز حالة HTTP القياسية. الحالات الشائعة:

الكودمعنى
400طلب سيء — معلمات غير صالحة
401غير مصرح به — مفتاح API مفقود أو غير صالح
403محظور - تم تعطيل مفتاح API
404لم يتم العثور عليه — المورد غير موجود
429عدد كبير جدًا من الطلبات - تم تجاوز الحد الأقصى للسعر
500خطأ داخلي في الخادم - حاول مرة أخرى لاحقًا

نقاط نهاية الخادم

تصفح وتصفية وفحص خوادم Minecraft التي يتم تتبعها بواسطة mcstat.org.

GET
/api/v1/servers

قائمة الخوادم

قائمة مرقّمة من الخوادم العامة مع مرشحات غنية.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers"

معلمات الاستعلام

الاسممطلوبالوصف
pageلارقم الصفحة يبدأ من 1.
limitلاالعناصر لكل صفحة.
sortلاترتيب الترتيب.
searchلاالاستعلام عن النص الحر.
countryلامرشح اسم البلد ISO.
versionلامرشح نسخة ماين كرافت.
tagلاتصفية حسب العلامة.
modeلامرشح وضع اللعبة.
minPlayersلاالحد الأدنى لعدد اللاعبين الحاليين
maxPlayersلاالحد الأقصى لعدد اللاعبين الحاليين.
minUptimeلاالحد الأدنى لنسبة وقت التشغيل.
minVotesلاالحد الأدنى لعدد الأصوات الإجمالية.
minRatingلاالحد الأدنى للتقييم (1-5).
onlineOnlyلاقم بتضمين الخوادم التي تقدم التقارير عبر الإنترنت فقط.

رد المثال

JSON
{
  "success": true,
  "data": {
    "servers": [
      {
        "id": "JS6o0w88QP6oZHDj",
        "slug": "mchypixelnet",
        "name": "Hypixel Network",
        "shortDescription": "Home of over 35 unique games…",
        "ip": "mc.hypixel.net",
        "port": 25565,
        "iconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp",
        "bannerUrl": "https://mcstat.org/media/banners/mchypixelnet.webp",
        "motdImageUrl": "https://mcstat.org/images/server-motd/mchypixelnet.svg",
        "motd": "Hypixel Network",
        "website": null,
        "discordUrl": null,
        "visibility": "PUBLIC",
        "isOnline": true,
        "currentPlayers": 48230,
        "maxPlayers": 200000,
        "version": "Requires MC 1.8 / 1.21",
        "latency": 42,
        "lastPing": "2026-05-24T22:00:00Z",
        "country": "United States",
        "tags": [
          "bedwars",
          "pvp",
          "skyblock"
        ],
        "gameMode": null,
        "uptime": 100,
        "trend": 3.4,
        "totalVotes": 12345,
        "rating": 4.6,
        "createdAt": "2026-04-28T05:44:26Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}
GET
/api/v1/servers/{slug}

تفاصيل الخادم

ملف تعريف الخادم الكامل: سجل الإحصائيات، وقت التشغيل، مخطط التصويت، الرتب.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/hypixel-net"

معلمات الاستعلام

الاسممطلوبالوصف
slugنعمسبيكة الخادم (من قائمة/الخوادم).
periodلاالنافذة الزمنية: 24h, 7d, 30d, 90d, all-time.

رد المثال

JSON
{
  "success": true,
  "data": {
    "server": {
      "id": "JS6o0w88QP6oZHDj",
      "slug": "mchypixelnet",
      "name": "Hypixel Network",
      "ip": "mc.hypixel.net",
      "port": 25565,
      "iconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp",
      "bannerUrl": "https://mcstat.org/media/banners/mchypixelnet.webp",
      "motd": "Hypixel Network",
      "motdRaw": "§aHypixel §7Network",
      "motdImageUrl": "https://mcstat.org/images/server-motd/mchypixelnet.svg",
      "website": null,
      "discordUrl": null,
      "storeUrl": null,
      "youtubeUrl": null,
      "currentPlayers": 48230,
      "maxPlayers": 200000,
      "isOnline": true,
      "country": "United States",
      "version": "Requires MC 1.8 / 1.21",
      "protocol": 767,
      "uptime": 100,
      "rating": 4.6,
      "totalVotes": 12345,
      "tags": [
        "bedwars",
        "pvp"
      ],
      "owner": null,
      "latestStats": {
        "onlinePlayers": 48230,
        "tps": 20,
        "timestamp": "2026-05-24T22:00:00Z"
      },
      "statsHistory": [
        {
          "timestamp": "2026-05-24T21:00:00Z",
          "onlinePlayers": 47000
        }
      ],
      "periodStats": {
        "24h": {
          "avgPlayers": 46500,
          "peakPlayers": 49100,
          "minPlayers": 42000,
          "uptimePct": 99.95
        }
      },
      "voteStats": {
        "24h": 412,
        "7d": 2890,
        "30d": 11200,
        "90d": 30150
      },
      "dailyVotes": [
        {
          "day": "2026-05-23",
          "votes": 405
        }
      ]
    }
  }
}
GET
/api/v1/servers/{slug}/voters

الناخبين الخادم

الناخبين الجدد (المصادق عليهم والمجهولين) للخادم المحدد.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/hypixel-net/voters"

معلمات الاستعلام

الاسممطلوبالوصف
slugنعمسبيكة الخادم (من قائمة/الخوادم).
pageلارقم الصفحة يبدأ من 1.
limitلاالعناصر لكل صفحة.

رد المثال

JSON
{
  "success": true,
  "data": {
    "voters": [
      {
        "id": "TanfrbogDfzGdrgD",
        "minecraftUsername": "Notch",
        "votedAt": "2026-05-24 22:10:06.544",
        "type": "auth",
        "playerId": "xq5-Lw8xk7pEdKyn",
        "minecraftUuid": "069a79f4-3e42-4b0c-8f1a-9c2b1d5e6f70",
        "skinUrl": "http://textures.minecraft.net/texture/cbea0a15a5ce…",
        "linkedSkinPngPath": "https://mcstat.org/media/skins/published/player-skin-notch.png",
        "skinModel": "classic",
        "siteUsername": "notch"
      }
    ],
    "total": 12345,
    "page": 1,
    "totalPages": 515,
    "latestVoteAt": "2026-05-24 22:10:06.544"
  }
}
GET
/api/v1/servers/{slug}/reviews

مراجعات الخادم

مراجعات وتقييمات اللاعبين مقسّمة إلى صفحات لخادم.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/hypixel-net/reviews"

معلمات الاستعلام

الاسممطلوبالوصف
slugنعمسبيكة الخادم (من قائمة/الخوادم).
pageلارقم الصفحة يبدأ من 1.
limitلاالعناصر لكل صفحة.

رد المثال

JSON
{
  "success": true,
  "data": {
    "reviews": [
      {
        "id": "5g4VgYUiN4n28qcX",
        "serverId": "JS6o0w88QP6oZHDj",
        "userId": null,
        "minecraftUsername": "chibibara",
        "rating": 3,
        "content": "Great community!",
        "createdAt": "2026-05-24T22:00:00Z",
        "updatedAt": "2026-05-24T22:00:00Z",
        "user": {
          "id": null,
          "username": "chibibara",
          "avatar": null,
          "role": "USER"
        },
        "playerId": "suTEw8opOK2bGP-L",
        "playerMainNickname": "chibibara",
        "playerMinecraftUuid": "019f1b29-fcbe-705b-8efb-8c08b4e0fd9c",
        "playerSkinUrl": null,
        "playerSkinModel": "classic",
        "playerLinkedSkinPngPath": "https://mcstat.org/media/skins/published/default-steve.png"
      }
    ],
    "total": 128,
    "page": 1,
    "totalPages": 26,
    "avgRating": 4.2,
    "latestReviewAt": "2026-05-24T22:00:00Z"
  }
}
GET
/api/v1/servers/{slug}/updates

تحديثات الخادم

منشورات الأخبار والتحديثات المعتمدة لخادم.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/hypixel-net/updates"

معلمات الاستعلام

الاسممطلوبالوصف
slugنعمسبيكة الخادم (من قائمة/الخوادم).
pageلارقم الصفحة يبدأ من 1.
limitلاالعناصر لكل صفحة.

رد المثال

JSON
{
  "success": true,
  "data": {
    "updates": [
      {
        "id": "Xk3pQ2mNbV8zR1sd",
        "serverId": "JS6o0w88QP6oZHDj",
        "userId": "Nf3kPq8sT2wVxJ7b",
        "title": "Season 5 is live!",
        "content": "New map, new kits, double XP weekend.",
        "status": "APPROVED",
        "createdAt": "2026-05-24T22:00:00Z",
        "updatedAt": "2026-05-24T22:00:00Z"
      }
    ],
    "total": 12,
    "page": 1,
    "totalPages": 4,
    "latestUpdateAt": "2026-05-24T22:00:00Z"
  }
}
GET
/api/v1/servers/top

أعلى الخوادم

تم تحسين قائمة الاتجاهات لاستخدام الصفحة الرئيسية/القطعة.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/top"

معلمات الاستعلام

الاسممطلوبالوصف
sortلاترتيب الترتيب.
limitلاالعناصر لكل صفحة.
countryلامرشح اسم البلد ISO.
gameModeلامرشح وضع اللعبة.

رد المثال

JSON
{
  "success": true,
  "data": {
    "servers": [
      {
        "id": "JS6o0w88QP6oZHDj",
        "slug": "mchypixelnet",
        "name": "Hypixel Network",
        "ip": "mc.hypixel.net",
        "iconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp",
        "bannerUrl": "https://mcstat.org/media/banners/mchypixelnet.webp",
        "motdImageUrl": "https://mcstat.org/images/server-motd/mchypixelnet.svg",
        "currentPlayers": 48230,
        "maxPlayers": 200000,
        "isOnline": true,
        "country": "United States",
        "totalVotes": 12345,
        "uptime": 100,
        "trend": 3.4,
        "recentVotes": 412,
        "hotScore": 9821
      }
    ],
    "total": 1240,
    "sort": "hot"
  }
}
GET
/api/v1/servers/countries

دول الخادم

العدد الإجمالي للخوادم مجمعة حسب البلد.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/countries"

معلمات الاستعلام

لا توجد معلمات

رد المثال

JSON
{
  "success": true,
  "data": {
    "countries": [
      {
        "country": "United States",
        "serverCount": 2840
      }
    ]
  }
}
GET
/api/v1/servers/versions

إصدارات الخادم

العدد الإجمالي للخوادم المجمعة حسب إصدار Minecraft.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/versions"

معلمات الاستعلام

لا توجد معلمات

رد المثال

JSON
{
  "success": true,
  "data": {
    "versions": [
      {
        "version": "Paper 1.21.11",
        "serverCount": 980
      }
    ]
  }
}

نقاط نهاية اللاعب

ابحث عن الملفات الشخصية للاعبين وجلساتهم ومستوياتهم وتاريخهم.

GET
/api/v1/players

قائمة اللاعبين

دليل المشغل العام المرقّم.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/players"

معلمات الاستعلام

الاسممطلوبالوصف
pageلارقم الصفحة يبدأ من 1.
limitلاالعناصر لكل صفحة.
sortلاترتيب الترتيب.
searchلاالاستعلام عن النص الحر.

رد المثال

JSON
{
  "success": true,
  "data": {
    "players": [
      {
        "id": "h6tC6lGfBEDulI8o",
        "minecraftUuid": "069a79f4-3e42-4b0c-8f1a-9c2b1d5e6f70",
        "mainNickname": "Notch",
        "skinUrl": "http://textures.minecraft.net/texture/98d4f27b450d…",
        "linkedSkinPngPath": "https://mcstat.org/media/skins/published/player-skin-notch.png",
        "skinModel": "classic",
        "country": "United States",
        "tierOverall": "HT1",
        "tierPoints": 9820,
        "tierRank": 12,
        "lastTierSyncAt": "2026-05-24T20:00:00Z",
        "createdAt": "2026-04-01T10:00:00Z",
        "totalPlayTime": 184320,
        "sessionCount": 412
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}
GET
/api/v1/players/{id}

تفاصيل اللاعب

الملف الشخصي، الجلسات الأخيرة، الخوادم التي تم تشغيلها، K/D، الإنجازات.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/players/069a79f4-44e9-4726-a5be-fca90e38aaf5"

معلمات الاستعلام

الاسممطلوبالوصف
idنعممعرف اللاعب أو UUID أو اللقب.

رد المثال

JSON
{
  "success": true,
  "data": {
    "player": {
      "id": "h6tC6lGfBEDulI8o",
      "minecraftUuid": "069a79f4-3e42-4b0c-8f1a-9c2b1d5e6f70",
      "mainNickname": "Notch",
      "nicknameHistory": [
        "Notch"
      ],
      "country": null,
      "skinModel": "classic",
      "skinUrl": "http://textures.minecraft.net/texture/98d4f27b450d…",
      "linkedSkinId": "Wi_n1dUvFqgJs0aP",
      "linkedSkinPngPath": "https://mcstat.org/media/skins/published/player-skin-notch.png",
      "linkedSkin": {
        "id": "Wi_n1dUvFqgJs0aP",
        "slug": "player-skin-notch",
        "pngPath": "https://mcstat.org/media/skins/published/player-skin-notch.png",
        "model": "classic",
        "name": "Notch's Skin"
      },
      "tierOverall": "MCStat Mythic",
      "tierPoints": 9820,
      "tierRank": 12,
      "createdAt": "2026-04-01T10:00:00Z",
      "updatedAt": "2026-05-24T22:00:00Z",
      "totalPlayTime": 184320,
      "sessionCount": 412,
      "rankScore": 9820,
      "rank": 12,
      "recentSessions": [
        {
          "id": "oWZiF6jq_UnEs7Y3",
          "server": {
            "id": "JS6o0w88QP6oZHDj",
            "slug": "mchypixelnet",
            "name": "Hypixel Network",
            "iconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp"
          },
          "joinedAt": "2026-05-24T20:00:00Z",
          "leftAt": "2026-05-24T21:00:00Z",
          "totalPlayTime": 3600
        }
      ],
      "serversPlayed": [
        {
          "id": "JS6o0w88QP6oZHDj",
          "slug": "mchypixelnet",
          "name": "Hypixel Network",
          "iconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp"
        }
      ],
      "latestStats": {
        "statsJson": {
          "kills": 18230,
          "deaths": 9850,
          "wins": 1240
        },
        "timestamp": "2026-05-24T21:00:00Z",
        "server": {
          "slug": "mchypixelnet",
          "name": "Hypixel Network"
        }
      },
      "statsHistory": [
        {
          "statsJson": {
            "kills": 18000,
            "deaths": 9700
          },
          "timestamp": "2026-05-24T20:00:00Z",
          "serverName": "Hypixel Network"
        }
      ],
      "kdRatio": 1.85,
      "totalKills": 18230,
      "totalDeaths": 9850,
      "totalWins": 1240,
      "activityData": [
        {
          "date": "2026-05-24",
          "count": 3
        }
      ],
      "achievements": {
        "earned": [
          {
            "id": "top10",
            "label": "Top 10",
            "labelTr": "İlk 10",
            "labelRu": "Топ 10",
            "icon": "medal"
          }
        ],
        "nextGoals": [
          {
            "id": "explorer_25",
            "label": "Globe Trotter",
            "labelTr": "Dünya Gezgini",
            "labelRu": "Путешественник",
            "icon": "plane"
          }
        ]
      },
      "votedServers": [
        {
          "serverId": "JS6o0w88QP6oZHDj",
          "serverSlug": "mchypixelnet",
          "serverName": "Hypixel Network",
          "serverIconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp",
          "votedAt": "2026-05-24T22:10:00Z"
        }
      ],
      "reviews": [
        {
          "id": "Rv8xKp2mNq7wTz1a",
          "rating": 5,
          "content": "Great server!",
          "createdAt": "2026-05-20T10:00:00Z",
          "server": {
            "id": "JS6o0w88QP6oZHDj",
            "slug": "mchypixelnet",
            "name": "Hypixel Network",
            "iconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp"
          }
        }
      ]
    }
  }
}

احصائيات حية وعالمية

النشاط العالمي في الوقت الحقيقي، وتفاصيل المنطقة والبلد.

GET
/api/v1/live

احصائيات حية

الإجماليات العالمية عبر الإنترنت، وأفضل الخوادم، والأنشطة الأخيرة، وتقسيم المنطقة والبلد.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/live"

معلمات الاستعلام

لا توجد معلمات

رد المثال

JSON
{
  "success": true,
  "data": {
    "stats": {
      "totalPlayers": 184320,
      "totalServers": 12480,
      "onlineServers": 9821,
      "newPlayersToday": 412,
      "peakToday": 202700,
      "generatedAt": "2026-05-24T22:00:00Z",
      "latestPingAt": "2026-05-24T21:59:48Z",
      "statsAgeSeconds": 18,
      "stale": false
    },
    "topServers": [
      {
        "id": "mchypixelnet",
        "name": "Hypixel Network",
        "players": 48230,
        "maxPlayers": 200000,
        "isOnline": true,
        "country": "United States",
        "trend": "up",
        "change": 240
      }
    ],
    "recentActivity": [
      {
        "type": "vote",
        "actor": "Notch",
        "target": "Hypixel Network",
        "time": "2026-05-24T22:00:00Z"
      }
    ],
    "regions": [
      {
        "id": "na",
        "name": "North America",
        "players": 80120,
        "servers": 4120
      }
    ],
    "countryPlayers": {
      "United States": 60120,
      "Germany": 18230
    }
  }
}
GET
/api/v1/live/history

التاريخ الحي

مجموعات كل ساعة لإجمالي اللاعبين عبر الإنترنت خلال آخر 7 أيام.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/live/history"

معلمات الاستعلام

لا توجد معلمات

رد المثال

JSON
{
  "success": true,
  "data": {
    "history": [
      {
        "timestamp": "2026-05-23T22:00:00Z",
        "totalPlayers": 174200
      }
    ]
  }
}

المتصدرين

تم تصنيف أفضل اللاعبين حسب الجلسات أو الخوادم أو نقاط المستوى.

GET
/api/v1/leaderboards

المتصدرين

أفضل اللاعبين لمرشحات المقياس والفترة والطبقة والإنجازات المحددة.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/leaderboards"

معلمات الاستعلام

الاسممطلوبالوصف
metricلامقياس التصنيف: best, sessions, servers.
periodلاالنافذة الزمنية: 24h, 7d, 30d, 90d, all-time.
pageلارقم الصفحة يبدأ من 1.
limitلاالعناصر لكل صفحة.
tierلامرشح الطبقة.
achievementلامرشح الإنجاز
searchلاالاستعلام عن النص الحر.

رد المثال

JSON
{
  "success": true,
  "data": {
    "leaderboard": {
      "metric": "best",
      "period": "all-time",
      "serverId": null,
      "generatedAt": "2026-05-24T22:00:00Z",
      "entries": [
        {
          "rank": 1,
          "player": {
            "id": "Vz2BaB2r6eC9TL_o",
            "mainNickname": "Notch",
            "minecraftUuid": "069a79f4-3e42-4b0c-8f1a-9c2b1d5e6f70",
            "tierOverall": "MCStat Mythic",
            "tierPoints": 224606,
            "tierRank": 1,
            "skinModel": "classic",
            "skinUrl": "http://textures.minecraft.net/texture/d71c3adef2ec…",
            "linkedSkinPngPath": "https://mcstat.org/media/skins/published/player-skin-notch.png"
          },
          "value": 224606,
          "formattedValue": "224,606 score"
        }
      ]
    },
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}

جلود ورؤوس

ابحث عن الجلود والرؤوس التي تم تحميلها من قبل المجتمع.

GET
/api/v1/skins

جلود القائمة

تصفح تحميلات مظهر المجتمع باستخدام الفرز/الفلتر.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/skins"

معلمات الاستعلام

الاسممطلوبالوصف
pageلارقم الصفحة يبدأ من 1.
limitلاالعناصر لكل صفحة.
sortلاترتيب الترتيب.
modelلانموذج الجلد: كلاسيكي أو نحيف.
searchلاالاستعلام عن النص الحر.
tagلاتصفية حسب العلامة.
ownerلاعامل تصفية اسم المستخدم للمالك.

رد المثال

JSON
{
  "success": true,
  "data": {
    "skins": [
      {
        "id": "Wi_n1dUvFqgJs0aP",
        "slug": "cool-knight",
        "name": "Cool Knight",
        "model": "classic",
        "tags": [
          "medieval",
          "armor"
        ],
        "pngPath": "https://mcstat.org/media/skins/published/cool-knight.png",
        "viewCount": 3120,
        "likeCount": 124,
        "favoriteCount": 88,
        "downloadCount": 980,
        "usageCount": 12,
        "isFeatured": false,
        "createdAt": "2026-05-01T10:00:00Z",
        "ownerId": "Nf3kPq8sT2wVxJ7b",
        "owner": {
          "id": "Nf3kPq8sT2wVxJ7b",
          "username": "notch",
          "avatar": "https://mcstat.org/media/avatars/notch.webp"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}
GET
/api/v1/skins/{slug}

تفاصيل الجلد

البيانات الوصفية الكاملة للبشرة بالإضافة إلى حالة الإعجاب/المفضلة لدى المشاهد.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/skins/hypixel-net"

معلمات الاستعلام

الاسممطلوبالوصف
slugنعمسبيكة الخادم (من قائمة/الخوادم).

رد المثال

JSON
{
  "success": true,
  "data": {
    "skin": {
      "id": "Wi_n1dUvFqgJs0aP",
      "slug": "cool-knight",
      "name": "Cool Knight",
      "description": "Custom medieval knight skin",
      "tags": [
        "medieval",
        "armor"
      ],
      "model": "classic",
      "pngPath": "https://mcstat.org/media/skins/published/cool-knight.png",
      "viewCount": 3120,
      "likeCount": 124,
      "favoriteCount": 88,
      "downloadCount": 980,
      "playersUsing": [
        {
          "id": "h6tC6lGfBEDulI8o",
          "mainNickname": "Notch",
          "minecraftUuid": "069a79f4-3e42-4b0c-8f1a-9c2b1d5e6f70",
          "skinUrl": "http://textures.minecraft.net/texture/98d4f27b450d…",
          "skinModel": "classic",
          "tierOverall": "MCStat Mythic",
          "linkedSkinPngPath": "https://mcstat.org/media/skins/published/cool-knight.png"
        }
      ],
      "playersUsingCount": 1,
      "owner": {
        "id": "Nf3kPq8sT2wVxJ7b",
        "username": "notch",
        "avatar": "https://mcstat.org/media/avatars/notch.webp"
      },
      "viewer": {
        "liked": false,
        "favorited": false,
        "isOwner": false
      }
    }
  }
}
GET
/api/v1/capes

قائمة الرؤوس

تصفح تحميلات المجتمع باستخدام الفرز/التصفية.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/capes"

معلمات الاستعلام

الاسممطلوبالوصف
pageلارقم الصفحة يبدأ من 1.
limitلاالعناصر لكل صفحة.
sortلاترتيب الترتيب.
searchلاالاستعلام عن النص الحر.
tagلاتصفية حسب العلامة.
ownerلاعامل تصفية اسم المستخدم للمالك.

رد المثال

JSON
{
  "success": true,
  "data": {
    "capes": [
      {
        "id": "De-jbTlj_PTnJJ5N",
        "slug": "royal-red",
        "name": "Royal Red",
        "tags": [
          "red",
          "royal"
        ],
        "pngPath": "https://mcstat.org/media/capes/published/royal-red.png",
        "viewCount": 210,
        "likeCount": 18,
        "favoriteCount": 6,
        "downloadCount": 44,
        "isFeatured": false,
        "createdAt": "2026-05-02T10:00:00Z",
        "ownerId": "Nf3kPq8sT2wVxJ7b",
        "owner": {
          "id": "Nf3kPq8sT2wVxJ7b",
          "username": "notch",
          "avatar": "https://mcstat.org/media/avatars/notch.webp"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}
GET
/api/v1/capes/{slug}

تفاصيل العباءة

بيانات وصفية كاملة للعباءة بالإضافة إلى حالة الإعجاب/المفضلة للمشاهد.

طلب مثال

cURL
curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/capes/hypixel-net"

معلمات الاستعلام

الاسممطلوبالوصف
slugنعمسبيكة الخادم (من قائمة/الخوادم).

رد المثال

JSON
{
  "success": true,
  "data": {
    "cape": {
      "id": "De-jbTlj_PTnJJ5N",
      "slug": "royal-red",
      "name": "Royal Red",
      "description": "Deep red royal cape",
      "tags": [
        "red",
        "royal"
      ],
      "pngPath": "https://mcstat.org/media/capes/published/royal-red.png",
      "viewCount": 210,
      "likeCount": 18,
      "favoriteCount": 6,
      "downloadCount": 44,
      "playersUsing": [
        {
          "id": "h6tC6lGfBEDulI8o",
          "mainNickname": "Notch",
          "minecraftUuid": "069a79f4-3e42-4b0c-8f1a-9c2b1d5e6f70",
          "skinUrl": "http://textures.minecraft.net/texture/98d4f27b450d…",
          "skinModel": "classic",
          "linkedSkinPngPath": "https://mcstat.org/media/skins/published/player-skin-notch.png",
          "tierOverall": "MCStat Mythic"
        }
      ],
      "playersUsingCount": 1,
      "owner": {
        "id": "Nf3kPq8sT2wVxJ7b",
        "username": "notch",
        "avatar": "https://mcstat.org/media/avatars/notch.webp"
      },
      "viewer": {
        "liked": false,
        "favorited": false,
        "isOwner": false
      }
    }
  }
}