Pacotes
Pacotes de backend & iniciantes
Copiar página
Clientes oficiais de backend Lia e projetos iniciais seguros para TypeScript, Python, PHP e Go.
Clientes de servidor oficiais para TypeScript/JavaScript, Python, PHP e Go. Eles chamam o mesmo servidor Lia do app API. Uma chave de teste vê registros de teste; uma chave ao vivo requer um app ao vivo e vê registros ao vivo.
#Gerar um backend
npx @lia-labs/create-app@latest backendEscolha Node.js HTTP ou Express, FastAPI ou Django, PHP HTTP, ou Go HTTP. Os backends gerados verificam sessões de jogadores de curta duração e cobranças pagas, mantêm SQLite inventários com recibos únicos, reconhecem a entrega após uma concessão bem-sucedida e reverterem reembolsos uma vez. O starter Node também inclui desafios de recompensa emitidos pelo servidor e uma varredura de recuperação limitada e paginada.
O CLI nunca pede que você cole um segredo em argumentos de terminal ou escreva um na interface do usuário. Defina LIA_SERVER_KEY e LIA_WEBHOOK_SECRET no seu servidor. Crie o coins-100 produto em Lia Developers, depois altere o mapeamento de direitos proprietários do servidor para seus produtos reais. Persista data/ em um volume durável. Para múltiplas instâncias de aplicação, substitua o armazenamento SQLite de amostra por um banco de dados transacional compartilhado. Configure HTTPS e limites de taxa específicos da aplicação no hospedagem de produção.
Exemplos de integração com frameworks estão incluídos para Express, Next.js App Router, Hono, FastAPI, Django e Laravel. Um adaptador de framework não pode determinar seu jogo's direito ou regras anti-trapaça; esses permanecem como código de aplicativo de propriedade do servidor.
#Instale em um backend existente
| Idioma | Pacote / código fonte | Instalar |
|---|---|---|
| JavaScript / TypeScript | @lia-labs/server | npm install @lia-labs/server |
| Python | lia-labs-server | pip install 'lia-labs-server @ git+https://github.com/The-Lia-Labs/lia-server-python.git@v0.1.0' |
| PHP | lia-labs/server | Adicione o repositório da empresa GitHub VCS abaixo, depois composer require lia-labs/server:^0.1.0 |
| Go | github.com/The-Lia-Labs/lia-server-go | go get github.com/The-Lia-Labs/lia-server-go@v0.1.0 |
Python é instalável a partir de sua fonte marcada GitHub; ainda não está listado em PyPI. PHP é instalável através do Composer VCS; ainda não está listado no Packagist.
{"repositories":[{"type":"vcs","url":"https://github.com/The-Lia-Labs/lia-server-php"}]}O nó suporta ESM e CommonJS e inclui tipos TypeScript. Python fornece LiaClient e AsyncLiaClient. PHP requer 8.2+ e cURL; o iniciador de inventário gerado também requer PDO SQLite. Go'o cliente usa a biblioteca padrão; seu estoque gerado usa SQLite através de CGO e precisa de um compilador C. Não importe esses pacotes em um pacote de navegador.
#Autenticar o jogador
import {LiaClient} from '@lia-labs/server';
const lia = new LiaClient(process.env.LIA_SERVER_KEY!);
const player = await lia.requireSession(sessionFromLia);
const {products} = await lia.listProducts();Python: lia.require_session(session); PHP: $lia->requireSession($session); Vá: client.RequireSession(ctx, session).
A interface do usuário envia a sessão retornada por Lia.init() ou Lia.session(), não um jogador ID ou sua chave de servidor. O resultado's exp é Unix milissegundos. Os clientes verificam a resposta'modo do jogador, forma e expiração. Renove a sessão do frontend quando ela expirar. O próprio API verifica assinaturas e propriedade do aplicativo.
#Operações
O contrato legível por máquina compartilhado é contrato de operação. Nomes abaixo são nomes TypeScript/PHP. Python usa snake_case e parâmetros de palavra-chave; Go usa PascalCase, context.Context, lia.Params e lia.RequestOptions.
| Área | Métodos |
|---|---|
| Sessões | verifySession, requireSession |
| Catálogo | listProducts |
| Compras | getCharge, deliverCharge, refundCharge, listPendingCharges |
| Recompensas LIA | payReward, getPool |
| Notificações | sendNotification |
| Anúncios recompensados | verifyAd, createAdChallenge, claimAdChallenge |
| Sala de multiplayer | listTables, saveTable, sitAtTable, removeTable |
| Pontuações autoritárias | listLeaderboards, saveLeaderboard, getLeaderboard, submitScore, moderateScore |
| Armazenamento exclusivo do servidor | getPlayerStorage, setPlayerStorage |
| Webhooks | listWebhookEvents, replayWebhookEvent, verificação de assinatura bruta e construção de eventos |
| Análise | getAnalytics, exportAnalytics |
Escritas de armazenamento requerem expectedVersion; um conflito é HTTP 409. JSON null é um valor armazenado válido. O acesso do navegador a esse armazenamento é somente leitura e vinculado à sessão'jogador. Os pontos devem vir de jogabilidade validada pelo servidor; mover um ponto não confiável para um ponto de extremidade do servidor não o torna autoritativo.
#Compras e repetições
- Busque a cobrança com a chave do servidor. Verifique
playerId,mode,productIde umpaid/deliveredstatus. - Em uma transação de banco de dados, insira um recibo único com chave por modo + carga ID e conceder o direito mapeado apenas se o recibo for novo.
- Comite o inventário, depois chame
deliverCharge. Tente novamente esse reconhecimento mesmo se o estoque já foi concedido. - Reconcile as cobranças pagas pendentes usando cada página do cursor. Reembolsos devem ser reverificados contra Lia e revertidos uma vez no seu banco de dados.
Todos os clientes usam um orçamento de solicitação de 15 segundos e, por padrão, no máximo duas repetições. Eles repetem falhas temporárias HTTP/de rede, respeitam Retry-After, recuse redirecionamentos autenticados e omita corpos de erro brutos de erros. Mutações mantêm o mesmo Idempotency-Key gerado e corpo serializado dentro de uma chamada. Passe uma chave de negócio estável ao repetir após reinícios do processo ou chamadas separadas.
await lia.deliverCharge({id: charge.id}, {idempotencyKey: `deliver:${charge.id}`});Python usa idempotency_key=...; PHP o considera como segundo argumento; Go usa lia.RequestOptions{IdempotencyKey: ...}. A verificação de sessão é um POST do tipo leitura e não cria um registro de idempotência desnecessário. LiaError inclui um código, HTTP status, solicitação ID e atraso de repetição. Nunca trate um 503 como um jogador inválido ou uma compra concluída. Verificação segura de GETs e sessão têm repetições limitadas; o comportamento exato uma vez financeiro também depende do API'e seu banco de dados'recibos únicos de negócios.
#Webhooks assinados
Verificar bytes brutos intocados antes da análise JSON com constructWebhookEvent (Nó), construct_webhook_event (Python), Webhooks::constructEvent (PHP), ou ConstructWebhookEvent (Vá). Use o Lia-Signature cabeçalho e sua app'segredo do webhook. A verificação rejeita cargas úteis alteradas e horários mais de cinco minutos no passado ou futuro. Tipos de eventos assinados desconhecidos podem ser reconhecidos sem conceder nada; test:true probes nunca concedem estoque.
Lia mantém uma caixa de saída durável com um evento ID estável. Tenta entregar imediatamente, depois de 1 minuto, 5 minutos, 30 minutos, 2 horas, 8 horas, 24 horas e 48 horas. Cada tentativa recebe um carimbo de hora de assinatura novo. Inspeção de metadados usando listWebhookEvents, e reexecute um evento após corrigir seu manipulador. Remova duplicatas usando recibos estáveis de negócios mesmo após uma reexecução. Não retorne 2xx antes que os compromissos de cumprimento sejam feitos.
#Desafios de recompensa
Crie um desafio no seu servidor com um contexto proprietário do servidor e jogador ID. Retorne challengeId para o frontend e passá-lo como rewardContextId quando solicitando um anúncio recompensado. Verificações de vinculação/declaração verificam o jogador, modo do aplicativo, formato do anúncio, idade, conclusão e reutilização. Uma declaração não concede inventário por si só; conceda seu jogo'seu direito uma vez por anúncio em sua própria transação.
Recompensas valiosas em tempo real exigem providerVerified:true. O novo fluxo de prova também precisa de um host nativo atualizado Lia para enviar o nonce por anúncio SSV e o callback AdMob SSV configurado. O suporte de backend sozinho não atualiza aplicativos já instalados. A conclusão nativa no modo de teste é evidência simulada, nunca prova assinada por provedor real.
Os anúncios reais no SDK Demo são limitados a 3 solicitações por dia UTC, com pelo menos 30 minutos de intervalo. Compras e recompensas LIA continuam simuladas. Atualize o Lia para usar este recurso.
#Análise
Relatórios incluem jogadores ativos diários, compras e conversão de pagadores, telemetria de anúncios por formato e D1/D7/D30 retenção. CSV contém tipos de registros de atividade, anúncios e retenção. A coleta de retenção começa com esta versão; coortes históricas não são inventadas. Cobertura incompleta de impressões de anúncios retorna métricas nulas. Receita relatada pelo SDK é uma estimativa, não receita AdMob finalizada ou um comprovante de pagamento para desenvolvedores.
Gerencie temporadas, oculte ou restaure pontuações, consulte tentativas de entrega de webhooks e reenvie eventos no Lia Developers. As análises incluem os apps da sua equipe e exportações CSV. Os dados de teste e de produção permanecem separados.
#Validação
Da empresa lia-sdk repositório:
npm install
python3 -m venv .venv
.venv/bin/pip install -e backends/python
LIA_PYTHON=.venv/bin/python npm run test:backends
npm run test:create-appInstale o Postman CLI, PHP com cURL e Go primeiro. Isso executa todos os quatro clientes reais por meio da simulação do Postman HTTP de primeira parte local, incluindo falhas temporárias, mutações repetidas, expiração de sessão, redirecionamentos, prazos e manipulação de webhooks. Ele não toca em dados de produção. Veja scripts/developer-server-features-local-test.mjs no repositório API para o teste de integração separado contra a implementação real do Worker local.
Traduzido automaticamente. O inglês é a fonte de verdade. Leia em inglês