Paquetes
Paquetes de backend & iniciadores
Copiar página
Clientes oficiales de backend para Lia, proyectos iniciales seguros para TypeScript, Python, PHP y Go.
Clientes de servidor oficial para TypeScript/JavaScript, Python, PHP y Go. Llaman al mismo servidor Lia de ámbito de aplicación API. Una clave de prueba ve registros de prueba; una clave en vivo requiere una aplicación en vivo y ve registros en vivo.
#Generar un backend
npx @lia-labs/create-app@latest backendElija Node.js HTTP o Express, FastAPI o Django, PHP HTTP, o Go HTTP. Los backends generados verifican sesiones de jugadores de corta duración y cargos pagados, mantienen inventarios SQLite con recibos únicos, reconocen la entrega después de un otorgamiento exitoso y revierten los reembolsos una vez. El iniciador de Node también incluye desafíos de recompensa emitidos por el servidor y un barrido de recuperación acotado y paginado.
El CLI nunca le pide que pegue un secreto en argumentos de terminal o escriba uno en la interfaz de usuario. Establezca LIA_SERVER_KEY y LIA_WEBHOOK_SECRET en su servidor. Cree el coins-100 producto en Lia Developers, luego cambie el mapeo de derechos propiedad del servidor para sus productos reales. Persista data/ en un volumen duradero. Para múltiples instancias de aplicación, reemplace la tienda SQLite de muestra con una base de datos transaccional compartida. Configure HTTPS y límites de tasas específicos de la aplicación en el alojamiento de producción.
Se incluyen ejemplos de integración de marcos para Express, Next.js App Router, Hono, FastAPI, Django y Laravel. Un adaptador de marco no puede determinar su juego'su derecho o reglas anti-trampa; esos permanecen como código de aplicación propiedad del servidor.
#Instalar en un backend existente
| Idioma | Paquete / código fuente | 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 | Añadir el repositorio de la empresa GitHub VCS debajo, luego 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 se puede instalar desde su código fuente etiquetado GitHub; aún no está listado en PyPI. PHP se puede instalar a través de Composer VCS; aún no está listado en Packagist.
{"repositories":[{"type":"vcs","url":"https://github.com/The-Lia-Labs/lia-server-php"}]}El nodo admite ESM y CommonJS e incluye tipos TypeScript. Python suministra LiaClient y AsyncLiaClient. PHP requiere 8.2+ y cURL; el generador de inventario inicial también requiere PDO SQLite. Go's cliente utiliza la biblioteca estándar; su inventario generador inicial utiliza SQLite a través de CGO y necesita un compilador C. No importe estos paquetes en un paquete de navegador.
#Autenticar al jugador
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); Ir a: client.RequireSession(ctx, session).
La interfaz de usuario envía la sesión devuelta por Lia.init() o Lia.session(), no un jugador ID o su clave de servidor. El resultado's exp es Unix milisegundos. Los clientes verifican la respuesta'modo, forma del jugador y caducidad. Renueva la sesión de la interfaz frontal cuando caduque. El propio API verifica las firmas y la propiedad de la aplicación.
#Operaciones
El contrato legible por máquina compartido es contrato de operación. Los nombres siguientes son nombres TypeScript/PHP. Python utiliza snake_case y parámetros con palabras clave; Go utiliza PascalCase, context.Context, lia.Params y lia.RequestOptions.
| Área | Métodos |
|---|---|
| Sesiones | verifySession, requireSession |
| Catálogo | listProducts |
| Compras | getCharge, deliverCharge, refundCharge, listPendingCharges |
| Premios LIA | payReward, getPool |
| Notificaciones | sendNotification |
| Anuncios recompensados | verifyAd, createAdChallenge, claimAdChallenge |
| Sala de juego multijugador | listTables, saveTable, sitAtTable, removeTable |
| Puntuaciones autoritativas | listLeaderboards, saveLeaderboard, getLeaderboard, submitScore, moderateScore |
| Almacenamiento exclusivo del servidor | getPlayerStorage, setPlayerStorage |
| Webhooks | listWebhookEvents, replayWebhookEvent, verificación de firma sin procesar y construcción de eventos |
| Análisis | getAnalytics, exportAnalytics |
Las escrituras en almacenamiento requieren expectedVersion; un conflicto es HTTP 409. JSON null es un valor almacenado válido. El acceso del navegador a este almacenamiento es de solo lectura y está vinculado a la sesión'jugador. Los puntajes deben provenir de un juego validado por el servidor; mover un puntaje no confiable a un punto final del servidor no lo hace autoritativo.
#Compras y reintentos
- Obtenga la carga con la clave del servidor. Compruebe
playerId,mode,productIdy unapaid/deliveredestado. - En una transacción de base de datos, insertar un recibo único con clave por modo + carga ID y otorgar el derecho asignado solo si el comprobante es nuevo.
- Confirme el inventario y luego llame a
deliverCharge. Vuelva a intentar esa confirmación incluso si el inventario ya fue otorgado. - Reconciliar cargos pagados pendientes utilizando cada página de cursor. Los reembolsos deben revisarse nuevamente contra Lia y anularse una vez en su base de datos.
Todos los clientes usan un presupuesto de solicitud de 15 segundos y como máximo dos reintentos por defecto. Reintentan fallas transitorias HTTP/de red, respetan Retry-After, rechazar redirecciones autenticadas y omitir cuerpos de error sin procesar de los errores. Las mutaciones mantienen el mismo Idempotency-Key generado y el cuerpo serializado dentro de una llamada. Pase una clave de negocio estable al reintentar en reinicios de proceso o llamadas separadas.
await lia.deliverCharge({id: charge.id}, {idempotencyKey: `deliver:${charge.id}`});Python utiliza idempotency_key=...; PHP lo toma como segundo argumento; Go usa lia.RequestOptions{IdempotencyKey: ...}. La verificación de sesión es un POST de lectura y no crea un registro de idempotencia innecesario. LiaError incluye un código, estado HTTP, solicitud ID y retraso de reintentos. Nunca trates un 503 como un jugador inválido o una compra completada. La verificación segura de GETs y sesión tiene reintentos limitados; el comportamiento exactamente una vez financiero también depende del API's y su base de datos'recibos únicos de negocios.
#Webhooks firmados
Verificar bytes sin procesar sin modificar antes del análisis JSON con constructWebhookEvent (Nodo), construct_webhook_event (Python), Webhooks::constructEvent (PHP), o ConstructWebhookEvent (Ir). Usa el Lia-Signature encabezado y tu aplicación'clave secreta del webhook. La verificación rechaza cargas útiles alteradas y marcas de tiempo más de cinco minutos en el pasado o futuro. Los tipos de eventos firmados desconocidos pueden ser reconocidos sin otorgar nada; test:true las sondas nunca otorgan inventario.
Lia mantiene un cuadro de salida duradero con un evento ID estable. Intenta la entrega inmediatamente, luego después de 1 minuto, 5 minutos, 30 minutos, 2 horas, 8 horas, 24 horas y 48 horas. Cada intento obtiene una marca de tiempo de firma nueva. Inspeccione los metadatos usando listWebhookEvents, y replica un evento después de corregir tu manejador. Elimina duplicados mediante recibos de negocios estables incluso después de una repetición. No devuelvas 2xx antes de que se comprometa la ejecución.
#Desafíos de recompensa
Cree un desafío en su servidor con un contexto propiedad del servidor y un jugador ID. Devuelva challengeId al frontend y pasarlo como rewardContextId al solicitar un anuncio recompensado. Las verificaciones de vinculación/afiliación comprueban al jugador, modo de aplicación, formato de anuncio, edad, finalización y reutilización. Un afiliación no otorga inventario por sí mismo; otorga tu juego's derecho una vez por anuncio en su propia transacción.
Recompensas valiosas en vivo requieren providerVerified:true. El nuevo flujo de prueba también necesita un anfitrión nativo actualizado Lia para enviar el nonce por anuncio SSV y la devolución de llamada AdMob SSV configurada. El soporte de backend solo no actualiza las aplicaciones ya instaladas. La finalización nativa en modo de prueba es evidencia simulada, nunca prueba firmada por proveedor real.
Los anuncios reales de SDK Demo se limitan a 3 solicitudes por día UTC, separadas por al menos 30 minutos. Las compras y las recompensas LIA siguen siendo simuladas. Actualiza Lia para usar esta función.
#Análisis
Los informes incluyen jugadores activos diarios, compras y conversión de pagadores, telemetría de anuncios por formato y retención D1/D7/D30. CSV contiene tipos de registros de actividad, anuncios y retención. La recopilación de retención comienza con esta versión; las cohortes históricas no se inventan. La cobertura incompleta de impresiones de anuncios devuelve métricas nulas. Los ingresos informados por SDK son una estimación, no los ingresos AdMob finales ni un estado de pago para desarrolladores.
Gestiona temporadas, oculta o restaura puntuaciones, revisa los intentos de entrega de webhooks y reenvía eventos desde Lia Developers. Las estadísticas incluyen las apps de tu equipo y exportaciones CSV. Los datos de prueba y de producción se mantienen separados.
#Validación
Desde la empresa lia-sdk repositorio:
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-appInstala Postman CLI, PHP con cURL y Go primero. Esto ejecuta a todos los cuatro clientes reales a través de la simulación de Postman HTTP de primera parte local, incluyendo fallos temporales, mutaciones repetidas, caducidad de sesión, redirecciones, plazos y manipulación de webhooks. No toca datos de producción. Vea scripts/developer-server-features-local-test.mjs en el repositorio API para la prueba de integración separada contra la implementación real del Worker local.
Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés