Vote API

పబ్లిక్ ఓట్ల API మీ ఇంటిగ్రేషన్‌లకు సర్వర్ ఓట్లను చదవడానికి అనుమతిస్తుంది: ఓట్ల జాబితాను తీసుకోవడం, నిర్దిష్ట ప్లేయర్ ఓటు వేశారా అని తనిఖీ చేయడం, గణాంకాలను చూడటం. ఓటు వేసిన వారికి Discord బాట్ ర్యాంక్ లేదా రివార్డ్ ఇవ్వడానికి ఇది చాలా తరచుగా ఉపయోగించబడుతుంది.

యాక్సెస్ రీడ్-ఓన్లీ — API ద్వారా మీరు ఓట్లను మార్చలేరు.

API కీని పొందడం

1. మీ సర్వర్ పేజీని తెరిచి ఓనర్ వెరిఫికేషన్ పూర్తి చేయండి.
2. సర్వర్ సెట్టింగ్‌లలో “API keys” విభాగాన్ని తెరిచి “Create key” నొక్కండి.
3. rsk_live_… లాగా కనిపించే కీని కాపీ చేయండి — ఇది ఒకసారి మాత్రమే చూపబడుతుంది. దాన్ని పాస్‌వర్డ్‌లా భద్రంగా ఉంచండి.

మీరు ఒక కీని ఒకే సర్వర్‌కు పరిమితం చేయవచ్చు లేదా మీ అన్ని సర్వర్ల కోసం జారీ చేయవచ్చు. లీక్ అయిన కీని అదే విభాగంలో రద్దు చేసి కొత్తది సృష్టించండి.

ముఖ్యం: కీని ఓపెన్ సోర్స్ కోడ్‌లో, రిపోజిటరీలో లేదా బహిరంగంగా అందుబాటులో ఉన్న బాట్ కాన్ఫిగ్‌లో ప్రచురించవద్దు. కీ లీక్ అయితే దాన్ని రద్దు చేయండి.

బేస్ URL మరియు ఆథరైజేషన్

బేస్ URL: https://api.millida.net/v2/rating/api

కీ X-Api-Key హెడర్‌లో (లేదా Authorization: Bearer …) పంపబడుతుంది:

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

కీ టెనెంట్ యొక్క అన్ని సర్వర్ల కోసం జారీ చేయబడి ఉంటే, ప్రతి రిక్వెస్ట్‌కు serverId పారామీటర్‌ను జోడించండి. ఒకే సర్వర్‌కు కట్టబడిన కీ కోసం ఈ పారామీటర్‌ను వదిలేయవచ్చు.

ప్లేయర్ ఓటును తనిఖీ చేయడం

Discord బాట్ కోసం ప్రధాన సినారియో: “ఈ వ్యక్తి ఓటు వేశారా”. ఎండ్‌పాయింట్ GET /votes/check.

పారామీటర్లు:

• discordId లేదా nickname — మీరు ఎవరిని తనిఖీ చేస్తున్నారు (వీటిలో ఒకటి తప్పనిసరి);
• since — కాలవ్యవధి: today (డిఫాల్ట్, UTCలో రోజు ప్రారంభం నుండి) లేదా గంటలు లేదా రోజుల సంఖ్య — 24h, 7d, 30d;
• serverId — కీ అన్ని సర్వర్ల కోసం జారీ చేయబడి ఉంటే తప్పనిసరి.

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 ద్వారా తనిఖీ గురించి: ప్లేయర్ తమ Millida ప్రొఫైల్‌లో పేర్కొంటేనే ఓటు Discord ఖాతాకు లింక్ అవుతుంది. కొంతమంది ప్లేయర్లకు 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ని టైట్ లూప్‌లో పోల్ చేయవద్దు.
• ఒక కీ మీ సర్వర్ల ఓట్లను మాత్రమే చూస్తుంది.