LiaDéveloppeurs

Paquets

Clients officiels Lia et projets de démarrage sécurisés pour TypeScript, Python, PHP et Go.

Clients de serveur officiels pour TypeScript/JavaScript, Python, PHP et Go. Ils appellent le même serveur Lia app-scoped API. Une clé de test voit des enregistrements de test ; une clé en direct nécessite une application en direct et voit des enregistrements en direct.

#Générer un backend

npx @lia-labs/create-app@latest backend

Choisissez Node.js HTTP ou Express, FastAPI ou Django, PHP HTTP, ou Go HTTP. Les backends générés vérifient les sessions de joueurs à court terme et les paiements, conservent les inventaires SQLite avec des reçus uniques, reconnaissent la livraison après un accord réussi, et annulent les remboursements une fois. Le démarrage Node inclut également des défis de récompenses émis par le serveur et un balayage de récupération borné et paginé.

Le CLI ne vous demande jamais de coller un secret dans les arguments de terminal ou d'écrire un secret dans l'interface frontale. Définir LIA_SERVER_KEY et LIA_WEBHOOK_SECRET sur votre serveur. Créez le coins-100 produit dans Lia Developers, puis modifiez le mappage des droits détenus par le serveur pour vos produits réels. Persister data/ sur un volume durable. Pour plusieurs instances d'application, remplacez le magasin SQLite d'exemple par une base de données transactionnelle partagée. Configurez HTTPS et les limites de taux spécifiques à l'application sur l'hébergement de production.

Des exemples d'intégration de framework sont inclus pour Express, Next.js App Router, Hono, FastAPI, Django et Laravel. Un adaptateur de framework ne peut pas déterminer votre jeu'sa répartition ou ses règles anti-triche ; celles-ci restent du code d'application propriétaire du serveur.

#Installer dans un backend existant

LanguePaquet / sourceInstaller
JavaScript / TypeScript@lia-labs/servernpm install @lia-labs/server
Pythonlia-labs-serverpip install 'lia-labs-server @ git+https://github.com/The-Lia-Labs/lia-server-python.git@v0.1.0'
PHPlia-labs/serverAjouter le dépôt de l'entreprise GitHub VCS ci-dessous, puis composer require lia-labs/server:^0.1.0
Gogithub.com/The-Lia-Labs/lia-server-gogo get github.com/The-Lia-Labs/lia-server-go@v0.1.0

Python est installable à partir de sa source taguée GitHub ; il n'est pas encore listé sur PyPI. PHP est installable via Composer VCS ; il n'est pas encore listé sur Packagist.

{"repositories":[{"type":"vcs","url":"https://github.com/The-Lia-Labs/lia-server-php"}]}

Le nœud prend en charge ESM et CommonJS et inclut les types TypeScript. Python fournit LiaClient et AsyncLiaClient. PHP exige 8.2+ et cURL ; le générateur d'inventaire initial exige également PDO SQLite. Go'le client utilise la bibliothèque standard ; son générateur d'inventaire de départ utilise SQLite à travers CGO et nécessite un compilateur C. Ne pas importer ces packages dans un bundle navigateur.

#Authentifier le joueur

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); Aller : client.RequireSession(ctx, session).

L'interface frontale envoie la session renvoyée par Lia.init() ou Lia.session(), pas un joueur ID ou votre clé de serveur. Le résultat's exp est Unix millisecondes. Les clients vérifient la réponse'le mode du joueur et la durée de validité. Renouvelez la session du frontend lorsqu'elle expire. C'est API qui vérifie les signatures et la propriété de l'application.

#Opérations

Le contrat lisible par machine partagé est contrat d'opération. Les noms ci-dessous sont des noms TypeScript/PHP. Python utilise le snake_case et les paramètres nommés ; Go utilise PascalCase, context.Context, lia.Params et lia.RequestOptions.

ZoneMéthodes
SessionsverifySession, requireSession
CataloguelistProducts
AchatsgetCharge, deliverCharge, refundCharge, listPendingCharges
Récompenses LIApayReward, getPool
NotificationssendNotification
Publicités récompenséesverifyAd, createAdChallenge, claimAdChallenge
Salle de jeu multijoueurlistTables, saveTable, sitAtTable, removeTable
Scores autoritatifslistLeaderboards, saveLeaderboard, getLeaderboard, submitScore, moderateScore
Stockage uniquement serveurgetPlayerStorage, setPlayerStorage
WebhookslistWebhookEvents, replayWebhookEvent, vérification de signature brute et construction d'événements
AnalytiquegetAnalytics, exportAnalytics

Les écritures de stockage nécessitent expectedVersion; un conflit est HTTP 409. JSON null est une valeur stockée valide. L'accès au navigateur de ce stockage est en lecture seule et lié à la session'le joueur. Les scores doivent provenir d'une partie validée par le serveur ; déplacer un score non fiable vers un point de terminaison serveur ne le rend pas autoritatif.

#Achats et réessais

  1. Récupérez la charge avec la clé serveur. Vérifiez playerId, mode, productId et un paid/delivered état.
  2. Dans une transaction de base de données, insérer un reçu unique clé par mode + charge ID et accorder le droit associé uniquement si le reçu est nouveau.
  3. Validez l'inventaire, puis appelez deliverCharge. Réessayez cette confirmation même si l'inventaire a déjà été accordé.
  4. Régler les charges payées en attente en utilisant chaque page de curseur. Les remboursements doivent être vérifiés à nouveau par rapport à Lia et annulés une fois dans votre base de données.

Tous les clients utilisent un budget de demande de 15 secondes et au plus deux tentatives par défaut. Ils réessayeront les échecs HTTP/réseau transitoires, respecteront Retry-After, refuser les redirections authentifiées et omettre les corps d'erreur bruts des erreurs. Les mutations conservent la même clé d'idempotence générée et le corps sérialisé au sein d'un appel. Transmettez une clé d'entreprise stable lors de la répétition après un redémarrage du processus ou des appels séparés.

await lia.deliverCharge({id: charge.id}, {idempotencyKey: `deliver:${charge.id}`});

Python utilise idempotency_key=...; PHP le prend comme deuxième argument ; Go utilise lia.RequestOptions{IdempotencyKey: ...}. La vérification de session est un POST de type lecture et ne crée pas d'enregistrement d'idempotence inutile. LiaError inclut un code, un statut HTTP, une demande ID et un délai de réessai. Ne traitez jamais un 503 comme un joueur invalide ou une acquisition terminée. Les vérifications sécurisées GETs et de session ont des réessais bornés ; le comportement exactement une fois financier repose également sur le API'et votre base de données'les reçus commerciaux uniques.

#Webhooks signés

Vérifier octets bruts non modifiés avant l'analyse JSON avec constructWebhookEvent (Nœud), construct_webhook_event (Python), Webhooks::constructEvent (PHP), ou ConstructWebhookEvent (Aller). Utilisez le Lia-Signature en-têtes et votre application'la clé secrète du webhook. La vérification rejette les charges utiles altérées et les horodatages plus anciens ou plus récents de cinq minutes. Les types d'événements signés inconnus peuvent être reconnus sans accorder quoi que ce soit ; test:true les sondes n'accordent jamais de stock.

Lia maintient une boîte de sortie durable avec un événement ID stable. Il tente immédiatement l'envoi, puis après 1 minute, 5 minutes, 30 minutes, 2 heures, 8 heures, 24 heures et 48 heures. Chaque tentative reçoit une signature avec une horodatage fraîche. Examinez les métadonnées en utilisant listWebhookEvents, et relancez un événement après avoir corrigé votre gestionnaire. Évitez les doublons en utilisant les reçus d'entreprise stables même après un relancement. Ne retournez pas 2xx avant que les engagements de réalisation ne soient effectués.

#Défis de récompense

Créez un défi sur votre serveur avec un contexte détenu par le serveur et un joueur ID. Retournez challengeId au frontend et de le transmettre en tant que rewardContextId lorsqu'une publicité récompensée est demandée. Les vérifications de liaison/affiliation vérifient le joueur, le mode d'application, le format de la publicité, l'âge, la complétion et la réutilisation. Une affiliation ne fournit pas d'inventaire par lui-même; accordez votre jeu'votre droit une fois par publicité dans votre propre transaction.

Des récompenses précieuses en temps réel nécessitent providerVerified:true. Le nouveau flux de preuve nécessite également un hôte natif mis à jour Lia pour envoyer le nonce par publicité SSV et le rappel AdMob SSV configuré. Le support backend seul ne met pas à niveau les applications déjà installées. La complétion native en mode test est une preuve simulée, jamais une preuve signée par un fournisseur réel.

Les publicités réelles dans SDK Demo sont limitées à 3 demandes par jour UTC, espacées d’au moins 30 minutes. Les achats et récompenses LIA restent simulés. Mettez Lia à jour pour utiliser cette fonctionnalité.

#Analytique

Les rapports comprennent les joueurs actifs quotidiens, les achats et la conversion des payeurs, les données de télémétrie publicitaire par format et la rétention D1/D7/D30. CSV contient les types d'enregistrements d'activité, d'annonces et de rétention. La collecte de la rétention commence avec cette version ; les cohortes historiques ne sont pas inventées. Une couverture incomplète des impressions publicitaires retourne des métriques nulles. Le revenu rapporté par SDK est une estimation, pas des revenus AdMob définitifs ou un relevé de paiement aux développeurs.

Gérez les saisons, masquez ou restaurez les scores, consultez les tentatives de livraison des webhooks et relancez les événements depuis Lia Developers. Les analyses incluent les applications de votre équipe et les exports CSV. Les données de test et de production restent séparées.

#Validation

De la société lia-sdk dépôt :

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-app

Installez Postman CLI, PHP avec cURL et Go d'abord. Cela exécute les quatre clients réels à travers la simulation Postman HTTP locale, y compris les pannes temporaires, les mutations répétées, l'expiration de session, les redirections, les délais et la manipulation des webhooks. Il ne touche pas les données de production. Voir scripts/developer-server-features-local-test.mjs dans le répertoire API pour le test d'intégration séparé contre l'implémentation réelle du Worker local.

Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais

Tapez pour rechercher sur toutes les pages, méthodes et points de terminaison.