API Nagród za Głosowanie
Gracze głosują na Twój serwer na metin2.gg i otrzymują nagrody w grze. Proste API REST — bez kodu C++.
Jak to działa
Trzy proste kroki. Bez specjalnego oprogramowania, bez kodu C++, bez skomplikowanej konfiguracji.
Gracz otwiera link do głosowania
Twoja gra wyświetla link jak metin2.gg/en/server/twoj-serwer?player_id=NazwaGracza. Gracz klika i głosuje.
Twój serwer sprawdza API
Proste zapytanie HTTP: GET /api/v1/vote/check?player_id=NazwaGracza z Twoim kluczem API. Zwraca true lub false.
Przyznaj nagrodę
Jeśli voted = true, daj graczowi nagrodę. Każdy głos jest automatycznie wykorzystywany przy pierwszym sprawdzeniu — podwójne nagrody nie są możliwe.
Korzyści partnerskie
Dodaj link zwrotny do metin2.gg na swojej stronie, aby odblokować status Partnera i wszystkie te korzyści za darmo.
API Nagród za Głosowanie
Pełny dostęp do API REST. Gracze głosują, Twój serwer automatycznie przyznaje nagrody w grze.
15% Boost w rankingu
Serwery partnerskie otrzymują 15% mnożnik głosów do obliczeń rankingowych. Awansuj szybciej.
Odznaka Partnera
Złota odznaka 'Partner' wyświetlana na liście Twojego serwera. Buduje zaufanie graczy.
Panel analityczny
Przeglądaj głosy dzienne, unikalnych głosujących, godziny szczytu, top głosujących i wskaźniki odbioru.
Widget do osadzenia
Interaktywny widget głosowania dla Twojej strony. Pokazuje pozycję, głosy i przycisk głosowania.
Webhooki
Otrzymuj natychmiastowe powiadomienia push, gdy gracze głosują. Nagrody w czasie rzeczywistym bez pollingu.
Co otrzymujesz — Podgląd panelu API
Tak wygląda panel ustawień API po skonfigurowaniu serwera. Wszystko jest samoobsługowe.
Dane dostępowe API
Key: mg_live_5bef...1a70
Szybki start
Dzieją się dwie rzeczy: gracze otwierają link do głosowania ze swoim imieniem, Twój serwer sprawdza API, aby przyznać nagrody.
Daj graczom link do głosowania
https://metin2.gg/en/server/your-server?player_id=PLAYER_NAMETwój serwer sprawdza, czy zagłosowali
GET /api/v1/vote/check?player_id=PlayerName
X-API-Key: mg_live_...Przyznaj nagrodę
{ "voted": true, "player_id": "PlayerName", "vote_id": "..." }{ "voted": false }Dlaczego metin2.gg?
Nowoczesne, bezpieczne, przyjazne dla programistów. Bez przestarzałych klientów C++ czy hashowania MD5.
| metin2.gg | Inne | |
|---|---|---|
| Integracja | Czyste API REST | Kod klienta C++ |
| Bezpieczeństwo | HMAC-SHA256 | MD5 |
| Tryby API | Polling + Webhook | Mylący tryb wielomodalny |
| Zarządzanie kluczami | Panel samoobsługowy | Ręczne pliki konfiguracyjne |
| Korzyści partnera | Odznaka + 15% boost + analityka | Brak |
| Dokumentacja | Pełna dokumentacja API + przykłady | Minimalna |
| Cooldown głosowania | 12 godzin | 24 godziny |
Zacznij w 5 minut
Darmowe dla wszystkich. Bez opłat, bez okresu próbnego.
Zgłoś swój serwer
Nie masz jeszcze serwera na metin2.gg? Dodaj go najpierw — zajmie to 2 minuty.
Zgłoś serwerZgłoś i zweryfikuj własność
Przejdź do Mój panel > Twój serwer > Zweryfikuj własność. Dodaj rekord DNS TXT lub meta tag, aby udowodnić, że serwer należy do Ciebie.
Przejdź do paneluDodaj link zwrotny do metin2.gg
Wklej link do metin2.gg gdziekolwiek na stronie Twojego serwera. Dostarczamy gotowe do skopiowania fragmenty na stronie ustawień API.
Wygeneruj klucz API
Gdy link zwrotny zostanie zweryfikowany, kliknij 'Wygeneruj klucz API' w ustawieniach API. Skopiuj klucz — jest wyświetlany tylko raz.
Zintegruj API
Dodaj jedno wywołanie HTTP do swojego serwera gry. Dostarczamy przykłady w Python, PHP i więcej. Gracze głosują, Ty przyznujesz nagrody.
Przewodnik IntegracjiFAQ
Czy API jest darmowe?
Tak, całkowicie darmowe. Bez opłat, bez ukrytych kosztów, bez okresu próbnego. Dodaj link zwrotny i zaczynaj.
Czy muszę modyfikować klienta gry?
Nie. To jest API REST po stronie serwera. Twój serwer gry wykonuje proste zapytanie HTTP. Bez kodu klienta C++ czy plików DLL.
Jakie języki programowania są obsługiwane?
Każdy język, który może wykonywać zapytania HTTP: Python, PHP, C++, C#, Java, Lua, Node.js — dostarczamy przykłady Python i PHP, ale API jest standardowym REST.
Czy gracze mogą oszukiwać lub odbierać nagrody podwójnie?
Nie. Każdy głos jest automatycznie wykorzystywany przy pierwszym sprawdzeniu API. Kolejne sprawdzenia tego samego głosu zwracają 'voted: false'. Używamy blokady optymistycznej, aby zapobiec warunkom wyścigu.
Jaki jest wymóg linku zwrotnego?
Dodaj dowolny link do metin2.gg na stronie Twojego serwera. Link HTML, obraz banneru lub nawet zwykły URL w stopce. Sprawdzamy automatycznie i dostarczamy gotowe do wklejenia fragmenty.
Co się stanie, jeśli usunę link zwrotny?
Masz 7-dniowy okres karencji. Jeśli link zwrotny nie zostanie przywrócony, dostęp do API zostaje wstrzymany (nie usunięty). Dodaj go ponownie i jesteś natychmiast reaktywowany.