Partner API

Vote шагнал

Тоглогч cs2servers.live дээр танай серверт Vote өгсөн эсэхийг өөрийн сайтаас шалгаж, шагнал (VIP, coin, skin…) өгөөрэй. Server owners can check, server to server, whether a Steam player voted for their community — and reward them.

1. 01

   API key үүсгэх

   /owner хуудсанд Steam-ээр нэвтэрч key үүсгэнэ. Key зөвхөн танай community-ийн санал дээр хариулна. Community-ийн эзэн гэж бүртгүүлэхийн тулд бидэнтэй холбогдоорой.
2. 02

   Шалгах

   curl https://cs2servers.live/api/partner/votes/check?steamid=76561199586861963 \
     -H "X-Partner-Key: cs2v_…"

   {
     "steamid": "76561199586861963",
     "community": "novacs",
     "voted": true,
     "first_voted_at": "2026-10-07T18:13:58Z",
     "last_voted_at": "2026-10-07T18:13:58Z",
     "total_votes": 1
   }

   // server side only — never ship the key to a browser
   const r = await fetch(
     `https://cs2servers.live/api/partner/votes/check?steamid=${steamId}`,
     { headers: { "X-Partner-Key": process.env.CS2SERVERS_KEY } },
   );
   const v = await r.json();
   if (v.voted) grantReward(steamId);   // remember you rewarded them, once

3. 03

   Хариу

   • 200 — voted: false бол хэзээ ч санал өгөөгүй (огноо null).
   • 400 invalid_steamid — SteamID64 буруу.
   • 401 unauthorized — key байхгүй, буруу эсвэл цуцлагдсан.
   • 429 rate_limited — нэг key минутад 60 хүсэлт. Retry-After толгойг хар.
   • Цаг бүгд UTC ISO 8601. Тоологдох нь зөвхөн хүлээн авсан санал; татгалзсан оролдлого тоологдохгүй.
4. 04

   Аюулгүй байдал

   • SteamID-г өөрийн Steam нэвтрэлтээс ав — тоглогчоор бичүүлж болохгүй, эс бөгөөс хэн ч хүний санал дээр шагнал авна.
   • Нэг тоглогчид нэг л удаа шагнал өгснөө өөрийн өгөгдлийн санд тэмдэглэ.
   • Key-г зөвхөн backend-д хадгал. Алдагдсан бол /owner дээр цуцлаад шинээр үүсгэ.