Быстрый старт

Подключите авторизацию на ваш сайт за 5 минут.

▲

1. Создайте аккаунт и проект

Зарегистрируйтесь на id.synapsea.agencyсоздайте проект в Dashboard и получите API-ключи.

Live Key: sa_live_xxxxxxxxxxxxxx
Test Key: sa_test_xxxxxxxxxxxxxx

2. Настройте провайдеров

В Dashboard → Проект → Провайдеры — добавьте нужных провайдеров (Google, VK, GitHub и т.д.) с credentials из их консолей разработчика. Callback URL для всех провайдеров:

https://auth.synapsea.agency/api/v1/auth/callback/{provider}

3. Добавьте кнопку на фронтенд

const res = await fetch('https://auth.synapsea.agency/api/v1/auth/sign-in/social', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Synapsea-Key': 'sa_live_xxxxxxx',
  },
  body: JSON.stringify({
    provider: 'google',
    method: 'oauth',
    callbackURL: 'https://yoursite.com/auth/callback',
  }),
});
const { url } = await res.json();
window.location.href = url;

4. Обработайте callback

В query будет sa_code (одноразовый). Обменяйте на токен через POST /api/v1/auth/exchange-code с заголовком X-Synapsea-Key.

const code = new URLSearchParams(location.search).get('sa_code');
const r = await fetch('https://auth.synapsea.agency/api/v1/auth/exchange-code', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Synapsea-Key': 'sa_live_xxxxxxx',
  },
  body: JSON.stringify({ code }),
});
const { token, user } = await r.json();

5. Готово!

Авторизация работает. Подробнее о каждом провайдере — на странице Провайдерыполный список эндпоинтов с интерактивным тестированием — в API Reference.