API Odměny za Hlasování
Hráči hlasují pro váš server na metin2.gg a získávají odměny ve hře. Jednoduché REST API — bez C++ klientského kódu.
Jak to funguje
Tři jednoduché kroky. Žádný speciální software, žádný C++ kód, žádné složité nastavení.
Hráč otevře hlasovací odkaz
Vaše hra zobrazí odkaz jako metin2.gg/en/server/vas-server?player_id=JmenoHrace. Hráč klikne a hlasuje.
Váš server zkontroluje API
Jednoduchý HTTP požadavek: GET /api/v1/vote/check?player_id=JmenoHrace s vaším API klíčem. Vrátí true nebo false.
Udělte odměnu
Pokud voted = true, dejte hráči jeho odměnu. Každý hlas se automaticky uplatní při první kontrole — žádné dvojité odměny nejsou možné.
Partnerské výhody
Přidejte zpětný odkaz na metin2.gg na svůj web a odemkněte status Partnera a všechny tyto výhody zdarma.
API Odměny za Hlasování
Plný přístup k REST API. Hráči hlasují, váš server automaticky uděluje herní odměny.
15% boost v žebříčku
Partnerské servery získávají 15% násobitel hlasů pro výpočet žebříčku. Stoupejte rychleji.
Partnerský odznak
Zlatý odznak 'Partner' zobrazený na záznamu vašeho serveru. Buduje důvěru hráčů.
Analytický panel
Prohlížejte hlasy za den, unikátní hlasující, špičkové hodiny, top hlasující a míry uplatnění.
Vložitelný widget
Interaktivní hlasovací widget pro váš web. Zobrazuje pozici, hlasy a tlačítko pro hlasování.
Webhooky
Dostávejte okamžité push notifikace, když hráči hlasují. Odměny v reálném čase bez pollingu.
Co získáte — Náhled API panelu
Takto vypadá panel nastavení API po nastavení serveru. Vše je samoobslužné.
Přístupové údaje API
Key: mg_live_5bef...1a70
Rychlý start
Dějí se dvě věci: hráči otevřou hlasovací odkaz se svým jménem, váš server zkontroluje API pro udělení odměn.
Dejte hráčům hlasovací odkaz
https://metin2.gg/en/server/your-server?player_id=PLAYER_NAMEVáš server zkontroluje, zda hlasovali
GET /api/v1/vote/check?player_id=PlayerName
X-API-Key: mg_live_...Udělte odměnu
{ "voted": true, "player_id": "PlayerName", "vote_id": "..." }{ "voted": false }Proč metin2.gg?
Moderní, bezpečné, přátelské pro vývojáře. Žádné zastaralé C++ klienty ani MD5 hashování.
| metin2.gg | Ostatní | |
|---|---|---|
| Integrace | Čisté REST API | C++ klientský kód |
| Zabezpečení | HMAC-SHA256 | MD5 |
| Režimy API | Polling + Webhook | Matoucí vícerežimový |
| Správa klíčů | Samoobslužný panel | Ruční konfigurační soubory |
| Partnerské výhody | Odznak + 15% boost + analytika | Žádné |
| Dokumentace | Kompletní API dokumentace + příklady | Minimální |
| Cooldown hlasování | 12 hodin | 24 hodin |
Začněte za 5 minut
Zdarma pro všechny. Žádné platby, žádné zkušební období.
Odešlete svůj server
Ještě nemáte server na metin2.gg? Přidejte ho nejdříve — trvá to 2 minuty.
Odeslat serverNárokujte a ověřte vlastnictví
Jděte na Můj panel > váš server > Ověřit vlastnictví. Přidejte DNS TXT záznam nebo meta tag pro prokázání vlastnictví.
Přejít na panelPřidejte zpětný odkaz na metin2.gg
Vložte odkaz na metin2.gg kamkoli na web vašeho serveru. Poskytujeme připravené úryvky ke zkopírování na stránce nastavení API.
Vygenerujte API klíč
Jakmile je zpětný odkaz ověřen, klikněte na 'Vygenerovat API klíč' v nastavení API. Zkopírujte klíč — zobrazí se pouze jednou.
Integrujte API
Přidejte jedno HTTP volání na váš herní server. Poskytujeme příklady v Pythonu, PHP a dalších. Hráči hlasují, vy udělujete odměny.
Průvodce IntegracíFAQ
Je API zdarma?
Ano, zcela zdarma. Žádné platby, žádné skryté poplatky, žádné zkušební období. Přidejte zpětný odkaz a jste přijati.
Musím upravit herního klienta?
Ne. Toto je serverové REST API. Váš herní server provede jednoduchý HTTP požadavek. Žádný C++ klientský kód ani DLL soubory nejsou potřeba.
Jaké programovací jazyky jsou podporovány?
Jakýkoli jazyk, který umí provádět HTTP požadavky: Python, PHP, C++, C#, Java, Lua, Node.js — poskytujeme příklady v Pythonu a PHP, ale API je standardní REST.
Mohou hráči podvádět nebo uplatnit odměny dvakrát?
Ne. Každý hlas se automaticky uplatní při první kontrole API. Následné kontroly stejného hlasu vrátí 'voted: false'. Používáme optimistické zamykání pro prevenci závodních podmínek.
Jaký je požadavek na zpětný odkaz?
Přidejte jakýkoli odkaz na metin2.gg na web vašeho serveru. HTML odkaz, obrázek banneru nebo dokonce prostou URL v patičce. Kontrolujeme automaticky a poskytujeme připravené úryvky k vložení.
Co se stane, když odstraním zpětný odkaz?
Máte 7denní ochrannou lhůtu. Pokud zpětný odkaz nebude obnoven, váš přístup k API bude pozastaven (ne smazán). Přidejte ho zpět a jste okamžitě reaktivováni.