Пакеты
Пакеты бэкенда & стартапы
Копировать страницу
Официальные клиенты бэкенда 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/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 | Добавьте корпоративный репозиторий GitHub VCS ниже, затем 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 устанавливается из его тегированного 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 |
| награды LIA | payReward, getPool |
| Уведомления | sendNotification |
| Реклама с вознаграждением | verifyAd, createAdChallenge, claimAdChallenge |
| Мультиплеер-lobby | listTables, saveTable, sitAtTable, removeTable |
| Авторитетные результаты | listLeaderboards, saveLeaderboard, getLeaderboard, submitScore, moderateScore |
| Хранилище только для сервера | getPlayerStorage, setPlayerStorage |
| Вебхуки | listWebhookEvents, replayWebhookEvent, проверка подписи в необработанном виде и построение событий |
| Аналитика | getAnalytics, exportAnalytics |
Записи в хранилище требуют expectedVersion; конфликт является HTTP 409. JSON null является допустимым сохраненным значением. Доступ браузера к этому хранилищу только для чтения и ограничен сеансом'игрока. Очки должны поступать из игровой деятельности, проверенной сервером; перемещение не доверенного счета в серверную точку не делает его авторитетным.
#Покупки и повторы
- Получите платеж с серверным ключом. Проверьте
playerId,mode,productIdиpaid/deliveredстатус. - В одной транзакции базы данных вставьте уникальный чек, используя в качестве ключа режим + оплата ID и предоставить сопоставленное право только в случае, если чек новый.
- Закоммитьте инвентарь, а затем вызовите
deliverCharge. Повторите подтверждение, даже если инвентарь уже был предоставлен. - Согласуйте непогашенные оплаченные платежи, используя каждую страницу курсора. Возвраты должны быть повторно проверены относительно 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.
Автоматически переведено. Английский — источник истины. Читать на английском