Server-to-Server интеграция

Caution

Активная разработка: Server-to-Server (S2S) интеграция в настоящее время находится в стадии активной разработки. Если вы планируете использовать её в production-среде, вам необходимо связаться с нами, чтобы запросить доступ и получить необходимые детали интеграции.

Note

S2S интеграция в настоящее время доступна только на тарифных планах MAX и Enterprise.

Обзор

Server-to-Server (S2S) интеграция позволяет вашему бэкенду взаимодействовать напрямую с движком оптимизации Hyperstone через REST API. Это идеальное решение для:

• Серверной игровой логики, требующей оптимизированных параметров.
• Приложений, где интеграция клиентского SDK невозможна.
• Сред с повышенными требованиями к безопасности, где конфигурация должна быть проверена на стороне сервера.

Цель этого руководства — показать, что интеграция Hyperstone в вашу существующую бэкенд-архитектуру проста и надежна.

Аутентификация и безопасность

Все S2S-запросы должны быть аутентифицированы с использованием вашего Application ID и Application Secret, которые можно найти в Консоли Hyperstone.

Подпись кастомных User ID

Для обеспечения целостности пользовательских данных Hyperstone требует, чтобы любые User ID (uid), предоставляемые клиентом, были криптографически подписаны. Если вы хотите использовать кастомные идентификаторы пользователей, свяжитесь с нашей командой инженеров.

Получение конфигурации

Чтобы получить оптимизированную конфигурацию для пользователя, ваш сервер отправляет запрос, содержащий атрибуты пользователя. Движок Hyperstone сопоставляет эти атрибуты с активными оптимизациями и возвращает лучшую конфигурацию.

Географические атрибуты (Geo-Location Attributes)

Для функций, основанных на географическом таргетинге (например, цены или сложность в зависимости от страны), вам следует:

1. Передавать IP-адрес конечного пользователя через стандартные заголовки (например, X-Forwarded-For).
2. Либо явно указывать атрибуты геолокации в теле запроса (payload).

Отслеживание метрик и вовлеченности

Поскольку S2S-интеграция обходит клиентский SDK, ваш бэкенд берет на себя ответственность за отслеживание и передачу метрик вовлеченности и сессий пользователей.

Отслеживание сессий и вовлеченности

Вам необходимо реализовать логику на своей стороне для отслеживания:

• Начала/Конца сессии (Session Start/End): когда пользователь начинает или заканчивает взаимодействие.
• Времени вовлеченности (Engagement Time): длительность активного участия пользователя.

Группировка и лимиты запросов (Batching & Rate Limits)

Для обеспечения высокой производительности и стабильности системы:

• Группируйте метрики (Batch Metrics): не отправляйте метрики по одной по мере их возникновения. Вместо этого накапливайте метрики на своей стороне и отправляйте их пакетами (батчами).
• Соблюдайте лимиты запросов (Rate Limits): S2S API имеет строгие лимиты на количество запросов. Группировка является основным способом оставаться в этих пределах, обеспечивая при этом сбор всех данных.

Дорожная карта интеграции

Так как эта функция находится в активной разработке, конкретные URL-адреса эндпоинтов и параметры запросов могут измениться. Мы рекомендуем связаться с нашей командой инженеров для получения актуальной спецификации API и участия в программе раннего доступа.