Vote API

सार्वजनिक वोट्स API की मदद से आपके इंटीग्रेशन किसी सर्वर के वोट्स पढ़ सकते हैं: वोट्स की लिस्ट लाएँ, देखें कि किसी खिलाड़ी ने वोट किया है या नहीं, और स्टैटिस्टिक्स देखें। इसका सबसे आम इस्तेमाल यह है कि Discord बॉट उन लोगों को रैंक या इनाम दे जिन्होंने वोट किया है।

एक्सेस रीड-ओनली है — API से आप वोट्स बदल नहीं सकते।

API key लेना

1. अपने सर्वर का पेज खोलें और owner verification पूरा करें।
2. सर्वर सेटिंग्स में “API keys” सेक्शन खोलें और “Create key” पर क्लिक करें।
3. key कॉपी करें, जो rsk_live_… जैसी दिखती है — यह एक बार ही दिखाई जाती है। इसे पासवर्ड की तरह संभालकर रखें।

आप key को किसी एक सर्वर तक सीमित कर सकते हैं या अपने सभी सर्वर के लिए जारी कर सकते हैं। लीक हुई key को उसी सेक्शन से रिवोक करें और नई बनाएँ।

ज़रूरी: key को ओपन सोर्स कोड, रिपॉज़िटरी या सार्वजनिक रूप से खुले बॉट कॉन्फ़िग में न छापें। अगर key लीक हो जाए, तो उसे रिवोक करें।

Base URL और authorization

Base URL: https://api.millida.net/v2/rating/api

key को X-Api-Key हेडर (या Authorization: Bearer …) में भेजा जाता है:

curl https://api.millida.net/v2/rating/api/stats \
  -H "X-Api-Key: rsk_live_YOUR_KEY"

अगर key tenant के सभी सर्वर के लिए जारी की गई है, तो हर रिक्वेस्ट में serverId पैरामीटर जोड़ें। किसी एक सर्वर से जुड़ी key के लिए यह पैरामीटर छोड़ सकते हैं।

खिलाड़ी का वोट चेक करना

Discord बॉट का मुख्य सिनेरियो: “क्या इस व्यक्ति ने वोट किया है”। एंडपॉइंट है GET /votes/check।

पैरामीटर:

• discordId या nickname — आप किसे चेक कर रहे हैं (इनमें से एक ज़रूरी है);
• since — अवधि: today (डिफ़ॉल्ट, UTC में दिन की शुरुआत से) या घंटों/दिनों की संख्या — 24h, 7d, 30d;
• serverId — ज़रूरी है अगर key सभी सर्वर के लिए जारी की गई है।

curl "https://api.millida.net/v2/rating/api/votes/check?discordId=123456789012345678&since=today" \
  -H "X-Api-Key: rsk_live_YOUR_KEY"

रिस्पॉन्स:

{
  "voted": true,
  "serverId": "srv…",
  "voteId": "clx…",
  "votedAt": "2026-06-16T10:12:00.000Z",
  "discordId": "123456789012345678",
  "nickname": "Steve",
  "since": "2026-06-16T00:00:00.000Z"
}

अगर voted true है, तो खिलाड़ी ने चुनी गई अवधि के लिए एक गिना गया वोट डाला है। सिर्फ़ वैध वोट गिने जाते हैं (बॉटिंग और रिजेक्ट किए गए वोट नहीं गिने जाते।)

Discord से चेक करने के बारे में: वोट किसी Discord अकाउंट से तभी जुड़ता है जब खिलाड़ी ने उसे अपनी Millida प्रोफ़ाइल में बताया हो। अगर कुछ खिलाड़ियों ने Discord लिंक नहीं किया है, तो nickname से चेक करें या खिलाड़ियों से कहें कि वे अपनी प्रोफ़ाइल में Discord लिंक करें।

वोट्स की लिस्ट

GET /votes सर्वर के वोट्स नए से पुराने के क्रम में लौटाता है।

पैरामीटर (सभी ऑप्शनल):

• status — VALID, HELD, REJECTED_FRAUD, REJECTED_RATE_LIMIT, REJECTED_NO_PLAY_HISTORY, या ALL (डिफ़ॉल्ट रूप से सभी लौटाए जाते हैं);
• discordId, nickname — खिलाड़ी के हिसाब से फ़िल्टर करें;
• from, to — ISO फ़ॉर्मैट में तारीख़ की रेंज;
• limit — कितने लौटाने हैं (1–200, डिफ़ॉल्ट 50);
• cursor — nextCursor फ़ील्ड से मिला अगले पेज का कर्सर।

curl "https://api.millida.net/v2/rating/api/votes?status=VALID&limit=100" \
  -H "X-Api-Key: rsk_live_YOUR_KEY"

रिस्पॉन्स:

{
  "votes": [
    {
      "id": "clx…",
      "serverId": "srv…",
      "discordId": "123456789012345678",
      "nickname": "Steve",
      "status": "VALID",
      "votedAt": "2026-06-16T10:12:00.000Z"
    }
  ],
  "nextCursor": "eyJ…"
}

अगला पेज पाने के लिए cursor में nextCursor डालकर रिक्वेस्ट दोहराएँ। जब nextCursor null हो, तो और डेटा नहीं है। वोटर्स के IP पते API से नहीं भेजे जाते।

स्टैटिस्टिक्स

GET /stats सर्वर के सारांश काउंटर लौटाता है:

{
  "serverId": "srv…",
  "validToday": 42,
  "valid24h": 50,
  "valid30d": 1280,
  "totalValid": 9001,
  "totalAll": 9500
}

उदाहरण: Discord बॉट वोट करने पर रोल देता है

async function hasVotedToday(discordId) {
  const res = await fetch(
    `https://api.millida.net/v2/rating/api/votes/check?discordId=${discordId}&since=today`,
    { headers: { "X-Api-Key": process.env.MILLIDA_RATING_KEY } },
  );
  const data = await res.json();
  return data.voted === true;
}

इस फ़ंक्शन को Discord कमांड से कॉल करें और अगर खिलाड़ी ने वोट किया है तो रोल दे दें।

सीमाएँ

• API रीड-ओनली है।
• रिक्वेस्ट रेट सीमित है — कमांड पर चेक करने के लिए यह काफ़ी से ज़्यादा है। API को लगातार लूप में पोल न करें।
• एक key सिर्फ़ आपके सर्वर के वोट्स देखती है।