API Ricompense Voto
I giocatori votano per il tuo server su metin2.gg e ricevono ricompense in gioco. API REST semplice — nessun codice C++ necessario.
Come funziona
Tre semplici passaggi. Nessun software speciale, nessun codice C++, nessuna configurazione complessa.
Il giocatore apre il link di voto
Il tuo gioco mostra un link come metin2.gg/en/server/tuo-server?player_id=NomeGiocatore. Il giocatore clicca e vota.
Il tuo server controlla l'API
Una semplice richiesta HTTP: GET /api/v1/vote/check?player_id=NomeGiocatore con la tua chiave API. Restituisce true o false.
Assegna la ricompensa
Se voted = true, dai al giocatore la sua ricompensa. Ogni voto viene riscattato automaticamente al primo controllo — nessuna doppia ricompensa possibile.
Vantaggi Partner
Aggiungi un backlink a metin2.gg sul tuo sito web per sbloccare lo status Partner e tutti questi vantaggi gratuitamente.
API Ricompense Voto
Accesso completo all'API REST. I giocatori votano, il tuo server assegna automaticamente ricompense in gioco.
Boost 15% nel ranking
I server partner ottengono un moltiplicatore del 15% sui voti per il calcolo del ranking. Sali più in fretta.
Badge Partner
Badge dorato 'Partner' mostrato nella scheda del tuo server. Costruisce fiducia con i giocatori.
Dashboard analitica
Visualizza voti giornalieri, votanti unici, ore di punta, top votanti e tassi di riscatto.
Widget incorporabile
Widget di voto interattivo per il tuo sito web. Mostra posizione, voti e un pulsante di voto.
Webhook
Ricevi notifiche push istantanee quando i giocatori votano. Ricompense in tempo reale senza polling.
Cosa ottieni — Anteprima pannello API
Ecco come appare il pannello delle impostazioni API una volta configurato il server. Tutto è self-service.
Credenziali API
Key: mg_live_5bef...1a70
Avvio rapido
Succedono due cose: i giocatori aprono un link di voto con il loro nome, il tuo server controlla l'API per assegnare le ricompense.
Dai ai giocatori un link di voto
https://metin2.gg/en/server/your-server?player_id=PLAYER_NAMEIl tuo server controlla se hanno votato
GET /api/v1/vote/check?player_id=PlayerName
X-API-Key: mg_live_...Assegna la ricompensa
{ "voted": true, "player_id": "PlayerName", "vote_id": "..." }{ "voted": false }Perché metin2.gg?
Moderno, sicuro, developer-friendly. Nessun client C++ obsoleto o hashing MD5.
| metin2.gg | Altri | |
|---|---|---|
| Integrazione | API REST pura | Codice client C++ |
| Sicurezza | HMAC-SHA256 | MD5 |
| Modalità API | Polling + Webhook | Multi-modalità confusa |
| Gestione chiavi | Pannello self-service | File di configurazione manuali |
| Vantaggi partner | Badge + boost 15% + analisi | Nessuno |
| Documentazione | Documentazione completa + esempi | Minimo |
| Cooldown voto | 12 ore | 24 ore |
Inizia in 5 minuti
Gratuito per tutti. Nessun pagamento, nessun periodo di prova.
Invia il tuo server
Non hai ancora un server su metin2.gg? Aggiungilo prima — ci vogliono 2 minuti.
Invia serverRivendica e verifica la proprietà
Vai in Il mio pannello > il tuo server > Verifica proprietà. Aggiungi un record DNS TXT o un meta tag per dimostrare che è tuo.
Vai al pannelloAggiungi un backlink a metin2.gg
Incolla un link a metin2.gg ovunque sul sito del tuo server. Forniamo snippet pronti da copiare nella pagina delle impostazioni API.
Genera la tua chiave API
Una volta verificato il backlink, clicca su 'Genera chiave API' nelle impostazioni API. Copia la chiave — viene mostrata una sola volta.
Integra l'API
Aggiungi una chiamata HTTP al tuo server di gioco. Forniamo esempi Python, PHP e altri. I giocatori votano, tu assegni le ricompense.
Guida all'IntegrazioneFAQ
L'API è gratuita?
Sì, completamente gratuita. Nessun pagamento, nessun costo nascosto, nessun periodo di prova. Aggiungi un backlink e sei dentro.
Devo modificare il mio client di gioco?
No. Questa è un'API REST lato server. Il tuo server di gioco fa una semplice richiesta HTTP. Nessun codice client C++ o file DLL necessari.
Quali linguaggi di programmazione sono supportati?
Qualsiasi linguaggio che possa fare richieste HTTP: Python, PHP, C++, C#, Java, Lua, Node.js — forniamo esempi Python e PHP, ma l'API è REST standard.
I giocatori possono barare o riscattare le ricompense due volte?
No. Ogni voto viene riscattato automaticamente al primo controllo API. I controlli successivi per lo stesso voto restituiscono 'voted: false'. Usiamo il blocco ottimistico per prevenire le condizioni di gara.
Qual è il requisito del backlink?
Aggiungi qualsiasi link a metin2.gg sul sito del tuo server. Un link HTML, un'immagine banner o anche un semplice URL nel footer. Controlliamo automaticamente e forniamo snippet pronti da incollare.
Cosa succede se rimuovo il backlink?
Hai un periodo di grazia di 7 giorni. Se il backlink non viene ripristinato, il tuo accesso API viene sospeso (non eliminato). Aggiungilo di nuovo e sei immediatamente riattivato.