LiaРазработчики

Пакеты

Официальные клиенты бэкенда Lia и безопасные стартовые проекты для TypeScript, Python, PHP и Go.

Официальные клиенты сервера для TypeScript/JavaScript, Python, PHP и Go. Они вызывают один и тот же сервер Lia в рамках приложения API. Тестовый ключ видит тестовые записи; живой ключ требует живого приложения и видит живые записи.

#Создайте бэкенд

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

Выберите Node.js HTTP или Express, FastAPI или Django, PHP HTTP, или Go HTTP. Сгенерированные бэкенды проверяют короткоживущие сессии игроков и оплаченные платежи, хранят SQLite инвентари с уникальными чеками, подтверждают доставку после успешного предоставления, и отменяют возвраты. Стартовый модуль Node также включает в себя серверные награды и ограниченный, пагинированный процесс восстановления.

Токен CLI никогда не просит вас вставлять секрет в аргументы терминала или записывать его в интерфейс. Установите LIA_SERVER_KEY и LIA_WEBHOOK_SECRET на вашем сервере. Создайте coins-100 продукт в Lia Разработчиках, а затем измените сопоставление прав на использование, принадлежащее серверу, для ваших реальных продуктов. Сохраните data/ на прочном объеме. Для нескольких экземпляров приложения замените образец SQLite хранилища на общую транзакционную базу данных. Настройте HTTPS и ограничения скорости, специфичные для приложения, на производственном хостинге.

Примеры интеграции фреймворков включены для Express, Next.js App Router, Hono, FastAPI, Django и Laravel. Адаптер фреймворка не может определить вашу игру'его право или правила анти-челленджа; эти остаются серверо-собственным прикладным кодом.

#Установите в существующий бэкенд

ЯзыкПакет / исходный кодУстановите
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/serverДобавьте корпоративный репозиторий GitHub VCS ниже, затем 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 устанавливается из его тегированного GitHub исходного кода; он еще не указан в PyPI. PHP устанавливается через Composer VCS; он еще не указан в Packagist.

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

Узел поддерживает ESM и CommonJS и включает типы TypeScript. Python предоставляет LiaClient и AsyncLiaClient. PHP требует 8.2+ и cURL; также требуется PDO SQLite для генерируемого инвентаря-стартера. Go'клиент использует стандартную библиотеку; его сгенерированный стартовый инвентарь использует SQLite через CGO и требует компилятора C. Не импортируйте эти пакеты в браузерный пакет.

#Аутентифицируйте игрока

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); Перейти: client.RequireSession(ctx, session).

Интерфейс отправляет сессию, возвращенную Lia.init() или Lia.session(), не игрок ID или ваш ключ сервера. Результат's exp является Unix миллисекунды. Клиенты проверяют ответ'режим, форма игрока и срок действия. Обновите сессию фронтенда, когда она истечет. Сам API проверяет подписи и принадлежность приложения.

#Операции

Общий машинно-читаемый контракт это контракт операции. Названия ниже являются TypeScript/PHP названиями. Python использует snake_case и ключевые параметры; Go использует PascalCase; context.Context, lia.Params и lia.RequestOptions.

ОбластьМетоды
СессииverifySession, requireSession
КаталогlistProducts
ПокупкиgetCharge, deliverCharge, refundCharge, listPendingCharges
награды LIApayReward, getPool
УведомленияsendNotification
Реклама с вознаграждениемverifyAd, createAdChallenge, claimAdChallenge
Мультиплеер-lobbylistTables, saveTable, sitAtTable, removeTable
Авторитетные результатыlistLeaderboards, saveLeaderboard, getLeaderboard, submitScore, moderateScore
Хранилище только для сервераgetPlayerStorage, setPlayerStorage
ВебхукиlistWebhookEvents, replayWebhookEvent, проверка подписи в необработанном виде и построение событий
АналитикаgetAnalytics, exportAnalytics

Записи в хранилище требуют expectedVersion; конфликт является HTTP 409. JSON null является допустимым сохраненным значением. Доступ браузера к этому хранилищу только для чтения и ограничен сеансом'игрока. Очки должны поступать из игровой деятельности, проверенной сервером; перемещение не доверенного счета в серверную точку не делает его авторитетным.

#Покупки и повторы

  1. Получите платеж с серверным ключом. Проверьте playerId, mode, productId и paid/delivered статус.
  2. В одной транзакции базы данных вставьте уникальный чек, используя в качестве ключа режим + оплата ID и предоставить сопоставленное право только в случае, если чек новый.
  3. Закоммитьте инвентарь, а затем вызовите deliverCharge. Повторите подтверждение, даже если инвентарь уже был предоставлен.
  4. Согласуйте непогашенные оплаченные платежи, используя каждую страницу курсора. Возвраты должны быть повторно проверены относительно Lia и отменены в вашей базе данных.

Все клиенты используют бюджет из 15 запросов в секунду и не более двух повторов по умолчанию. Они повторяют запросы при временных сбоях HTTP/сети, соблюдая Retry-After, отказ от аутентифицированных перенаправлений и исключение необработанных тел ошибок из ошибок. Мутации сохраняют тот же сгенерированный Idempotency-Key и сериализованное тело в рамках вызова. При повторных попытках после перезапуска процесса или отдельных вызовов передавайте стабильный ключ бизнеса.

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

Python использует idempotency_key=...; PHP принимает его как второй аргумент; Go использует lia.RequestOptions{IdempotencyKey: ...}. Проверка сессии — это операция чтения POST и не создает ненужную запись идемпотентности. LiaError включает код, HTTP статус, запрос ID и задержку повтора. Никогда не рассматривайте 503 как недействительного игрока или завершенную покупку. Безопасная GETs и проверка сессии имеют ограниченное количество повторов; финансовая семантика «ровно один раз» также зависит от API'и ваша база данных'уникальные бизнес-чеки.

#Подписанные вебхуки

Проверить неприкосновенные необработанные байты до парсинга JSON с constructWebhookEvent (Узел), construct_webhook_event (Python), Webhooks::constructEvent (PHP), или ConstructWebhookEvent (Перейдите). Используйте Lia-Signature заголовок и ваше приложение'секрет вебхука. Проверка отвергает измененные данные и временные метки, которые находятся более чем на пять минут в прошлом или будущем. Неизвестные типы подписанных событий могут быть признаны без предоставления чего-либо; test:true датчики никогда не предоставляют инвентарь.

У Lia есть надежная очередь исходящих сообщений с устойчивым событием ID. Он немедленно пытается доставить, затем через 1 минут, 5 минут, 30 минут, 2 часов, 8 часов, 24 часов и 48 часов. Каждая попытка получает свежую временную метку подписи. Изучите метаданные с помощью listWebhookEvents, и воспроизведите событие после исправления вашего обработчика. Удаляйте дубликаты с помощью стабильных бизнес-чеков, даже после повторного воспроизведения. Не возвращайте 2xx до завершения выполнения.

#Вызовы вознаграждений

Создайте вызов на вашем сервере с контекстом, принадлежащим серверу, и идентификатором игрока ID. Верните challengeId в интерфейс и передать как rewardContextId при запросе вознаграждённой рекламы. Проверки привязки/заявки проверяют игрока, режим приложения, формат рекламы, возраст, завершение и повторное использование. Заявка сам по себе не предоставляет инвентаря; предоставьте свою игру'доступ один раз на рекламу в вашей собственной транзакции.

Живые ценные вознаграждения требуют providerVerified:true. Новый поток доказательств также требует обновленного нативного Lia хоста для отправки пер-рекламного SSV nonce и AdMob SSV обратного вызова, настроенного. Поддержка бэкенда сама по себе не обновляет уже установленные приложения. Тестовый режим нативного завершения - это имитируемое доказательство, никогда не реальное доказательство, подписанное поставщиком.

Реальные объявления в SDK Demo ограничены 3 запросами за сутки UTC с интервалом не менее 30 минут. Покупки и награды LIA остаются имитацией. Для этой функции обновите Lia.

#Аналитика

Отчеты включают ежедневных активных игроков, покупки и конверсию плательщиков, телеметрию рекламы по форматам и D1/D7/D30 удержание. CSV содержит типы записей деятельности, рекламы и удержания. Сбор удержания начинается с этого выпуска; исторические когорты не создаются. Неполное покрытие показов рекламы возвращает нулевые метрики. Доход, отчетный SDK, является оценкой, а не окончательными AdMob доходами или заявлением на выплату разработчику.

Управляйте сезонами, скрывайте или восстанавливайте результаты, просматривайте попытки доставки вебхуков и повторно отправляйте события в Lia Developers. Аналитика включает приложения вашей команды и экспорт CSV. Тестовые и рабочие данные хранятся отдельно.

#Проверка

От компании lia-sdk репозиторий:

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

Установите Postman CLI, PHP с cURL и Go. Это запускает все четыре реальных клиента через локальную симуляцию первого партнера Postman HTTP, включая временные сбои, повторные изменения, истечение срока сессии, перенаправления, дедлайны и подделку вебхуков. Это не влияет на производственные данные. См. scripts/developer-server-features-local-test.mjs в API репозитории для отдельного теста интеграции с реальной локальной реализацией Worker.

Автоматически переведено. Английский — источник истины. Читать на английском

Введите, чтобы искать по каждой странице, методу и точке окончания.