API Gateway v2.4 · Все сервисы онлайн (99.98% SLA)
Платформа и сервисы для разработчиков
Проектируйте интерактивные WebApp-приложения, подключайте ботов и автоматизации, интегрируйте внешние микросервисы через событийно-ориентированный REST API и безопасный шлюз авторизации OAuth 2.0.
0
Моих WebApp
0
Моих ботов
0
API Ключей
14мс
Latency шлюза
Архитектурные возможности платформы Sociq
Расширяемый стек инструментов для встраиваемых приложений, ботов и интеграции внешних сервисов.
WebApp (Mini-Apps)
Полнофункциональные HTML5/React/Vue приложения внутри соцсети. Безопасная песочница, нативный мост JavaScript SDK, автоматическая передача данных авторизации и темы оформления.
Боты & Автоматизация
Интеллектуальные боты для личных диалогов, каналов и комментариев. Мгновенные Webhook-события с криптографической проверкой подлинности HMAC-SHA256.
Шлюз API & Микросервисы
OAuth 2.0 Client Credentials Grant, разграничение прав (Scopes RBAC), Rate Limiting (5,000 req/min), гарантированная доставка событий через Outbox Queue и сквозной аудит.
Быстрый старт за 3 шага
От идеи до работающей интеграции в каталоге за 5 минут
1
Выпустите API-ключ
В разделе «API Ключи» создайте учетную запись, выберите нужные права (Scopes) и сохраните Client ID и Client Secret.
2
Подключите SDK или Webhook
Для WebApp подключите библиотеку window.SociqApp. Для ботов настройте обработчик POST-запросов с валидацией подписи.
Client ID и Client Secret для OAuth 2.0 Client Credentials Grant
Политика безопасности учётных данных
При выпуске нового ключа параметр client_secret отображается только один раз. Обязательно сохраните его в защищённом хранилище конфигураций вашего сервера. Никогда не передавайте Client Secret в клиентский код браузера или публичные репозитории!
Требуется авторизация
Войдите в аккаунт, чтобы выпускать API-ключи для интеграций с платформой.
Слабосвязанный стек компонентов, событийная модель (Event-Driven) и шлюз API
Frontend Client
WebApp / Bots / CRM
Интерфейс, JS SDK, Webhook слушатели
Core Gateway
Sociq API Gateway
Rate Limit · RBAC Scopes · Correlation ID
Async Outbox
Event Bus & Workers
Очереди задач, повторы, аудит операций
Стандарты подключения микросервисов:
Health Check Endpoint: каждый подключенный микросервис обязан реализовать эндпоинт доступности (например, GET /health или GET /ping), возвращающий HTTP 200 и JSON {"status":"ok","uptime":3600,"version":"1.0"}. Платформа непрерывно мониторит состояние и фиксирует время задержки (Latency).
Сквозная трассировка (Correlation-ID): платформа передаёт во всех запросах заголовок X-Correlation-ID, который необходимо сохранять в логах вашего сервиса для сквозного аудита инцидентов.
Гарантия доставки через Outbox: события между сервисами фиксируются в транзакционном реестре platform__events_outbox с гарантией доставки at-least-once и фоновым воркером cron.php.
Глава 2
Авторизация по протоколу OAuth 2.0
Получение Bearer-токена для вызова серверных методов REST API
Для выполнения запросов к API внешние бэкенды используют протокол Client Credentials Grant.
Вы отправляете ваш client_id и client_secret, полученные в разделе «API Ключи», и получаете временный токен доступа (Bearer Token) со сроком жизни 24 часа (86 400 секунд).
Встраивание интерактивных интерфейсов, игр и сервисов в соцсеть
WebApp загружается в изолированном <iframe> внутри контейнера социальной сети.
Для безопасного взаимодействия с интерфейсом соцсети используется библиотека-мост SociqApp SDK.
HTML / JavaScript
<!-- Подключение официального JS SDK -->
<script src="https://my45.ru/assets/appearance/standart/js/apps-bridge.js"></script>
<script>
// 1. Уведомить соцсеть о готовности интерфейса (скрывает индикатор загрузки)
window.SociqApp.ready();
// 2. Развернуть приложение на полную высоту окна
window.SociqApp.expand();
// 3. Получить данные авторизованного пользователя
const user = window.SociqApp.initDataUnsafe.user;
console.log('Пользователь:', user.id, user.first_name);
// 4. Отправка полезной нагрузки родительскому окну соцсети
function finishOrder(orderId) {
window.SociqApp.sendData(JSON.stringify({ order_id: orderId, status: 'completed' }));
}
</script>
Справочник методов и свойств объекта window.SociqApp:
Метод / Свойство
Тип
Описание
SociqApp.ready()
Method
Уведомляет контейнер соцсети о завершении начальной отрисовки интерфейса. Скрывает загрузчик.
SociqApp.expand()
Method
Разворачивает фрейм приложения на максимально доступную высоту экрана.
SociqApp.close()
Method
Закрывает WebApp и плавно возвращает пользователя на предыдущую страницу соцсети.
SociqApp.sendData(payload)
Method
Отправляет строковую полезную нагрузку (JSON string) контейнеру соцсети для обработки.
SociqApp.showAlert(msg)
Method
Вызывает нативный диалог оповещения социальной сети.
SociqApp.openLink(url)
Method
Безопасно открывает внешнюю ссылку в отдельной вкладке браузера.
SociqApp.initData
String
Сырая строка параметров запуска, подписанная HMAC-SHA256, для отправки на ваш бэкенд.
SociqApp.initDataUnsafe
Object
Распарсенный объект параметров с ID, именем и аватаром пользователя для быстрой отрисовки.
Глава 4
Криптографическая проверка подписи initData
Аутентификация пользователя на вашем сервере без передачи паролей
Каждый запуск WebApp снабжается строкой initData.
Чтобы злоумышленник не мог подделать user_id на клиенте, серверная часть вашего приложения обязана валидировать подпись hash по вашему Client Secret.
Приём сообщений и событий платформы с валидацией заголовка X-Sociq-Signature
Когда пользователь отправляет сообщение боту или упоминает его, шлюз Sociq немедленно отправляет HTTP POST запрос на указанный вами Webhook URL.
Проверка подлинности вебхука:
Каждый запрос сопровождается заголовком X-Sociq-Signature: sha256=<hmac>, вычисленным по секретному токену вашего бота от сырого тела входящего запроса: