Conceitos

Potes de recompensas

Copiar página

Lia pode financiar um pool de $LIA para o seu app. Seu servidor paga os jogadores a partir dele, uma vez por recompensa, dentro do pool e do limite diário por jogador.

#O que é um pool

Um pool de recompensas é $LIA da equipe Lia que reserva para o seu app de Lia'da tesouraria. Seu servidor paga os jogadores a partir dela: por vencer um torneio, completar uma missão, assistir a um vídeo, qualquer coisa que seu app decida. O $LIA vai direto para o jogador's saldo em Lia, e aparece em sua atividade sob o seu app's nome com o motivo que você der.

A equipe Lia decide se seu app tem uma pool, a financia e pode aumentá-la ou recolher parte. Pergunte sobre uma quando você fale conosco.

#Pagando uma recompensa

Seu servidor chama POST /rewards com sua chave secreta:

{
  "playerId": "p_3f9c0a6d1b2e4f5a6b7c",
  "amount": 25,
  "key": "tournament-2026-11-01:p_3f9c0a6d1b2e4f5a6b7c",
  "reason": "Weekly tournament, 1st place"
}

Recompensas vêm apenas do seu servidor. Lá's não tem chamada SDK para eles, porque uma página pode'não seja confiável para dizer o que alguém ganhou.

#Uma vez por chave

Todo prêmio tem um chave que você escolher, até 128 caracteres de letras, dígitos, _, ., : e -. Uma chave paga uma vez, para sempre: enviar a mesma chave novamente paga nada e responde { "status": "duplicate" } com o valor que ele pagou pela primeira vez. Então:

Faça a chave dizer o que o prêmio é para, então um novo tentativa ou um clique duplo pode'pagar duas vezes: daily:2026-11-01:p_3f9c…, quest-7:p_3f9c…, ad:ad_8e1c….
Ele'é seguro tentar novamente uma recompensa após um tempo limite com a mesma chave.

#Limites

Limite	O que acontece
Um prêmio é mais do que 0 e no máximo 10,000 LIA, para 6 casas decimais.	`400 bad_amount`
O pool deve manter o valor.	`409 pool_empty`, com o que's restantes e o limite diário. Observe o saldo e peça à equipe para recarregá-lo antes que acabe.
Um jogador pode obter no máximo o limite diário por jogador de sua pool em um dia (UTC). A equipe Lia define; 0 significa sem limite.	`429 daily_limit`, com o limite

GET /pool diz ao seu servidor o que's restante é escuro o suficiente para texto branco, e o assunto está à direita.

#Modo de teste

Com sua chave de teste, as recompensas são fictícias: elas'é gravado e seu webhook é enviado, mas seu pool não é'para usar. O limite diário não't aplicar, e nenhum $LIA chega ao jogador. As chaves ainda são apenas uma vez.

#Webhooks

Todo prêmio pago envia um reward.paid webhook com sua chave secreta, jogador, valor, motivo e modo. Uma duplicata envia nada.

Recompense os jogadores reúne tudo isso com um bônus diário como exemplo.

Traduzido automaticamente. O inglês é a fonte de verdade. Leia em inglês