API de votos
Cadastre o servidor, aguarde a aprovação e copie o Server ID e a chave gerada no painel. A API usa o campo booleano voted esperado pelo adaptador Hopzone fornecido.
Consulta de voto
GET https://l2jone.com/api/vote?server_id=123&ip_address=203.0.113.10 Authorization: Bearer SUA_CHAVE_PRIVADA
Para clientes que usam o formato Hopzone, também aceitamos a chave no parâmetro token. O Server ID é recomendado; se omitido, a chave identifica o servidor.
GET https://l2jone.com/api/vote?server_id=123&token=SUA_CHAVE&ip_address=203.0.113.10
{
"voted": true,
"server_id": 123,
"last_vote": 1789128000,
"next_vote": 1789171200
}voted é verdadeiro por 12 horas após o último voto desse IP. Os horários são Unix timestamps em segundos, UTC; sem voto, são null. A consulta não registra nem consome votos. O jogador vota na página pública após entrar em sua conta e confirmar o formulário.
Configuração sugerida
L2JOneServerId = 123 L2JOneApiKey = SUA_CHAVE_PRIVADA
Essas configurações exigem o adaptador L2JOne no gameserver. Somente preencher a configuração Hopzone não redireciona o código existente: o Java original contém a URL Hopzone fixa e uma lista de domínios permitidos. O pacote de integração inclui a adaptação separada do código.
Respostas e limites
HTTP 200: consulta válida, com voted verdadeiro ou falso. HTTP 400: IP inválido. HTTP 401: chave/ID inválidos ou servidor inativo. HTTP 429: limite excedido (600 consultas por minuto por servidor e 1.200 por IP). HTTP 503: indisponibilidade temporária. Respostas de erro incluem voted: false e error.
Recompensa no jogo
Consulte por HTTPS usando o IP real do jogador. Não exponha a chave ao jogador. Mantenha no gameserver o controle persistente de recompensa por conta e IP, com intervalo mínimo de 12 horas. Repetir uma consulta válida continuará retornando verdadeiro; isso não autoriza entregar a recompensa novamente.