Начало интеграции

Коллекция запросов

У API-документации есть коллекция запросов с примерами.

Авторизация

Это API использует авторизацию bearer authentication, используя ключ API для вашего проекта.

Ваш заголовок авторизации должен выглядеть примерно так:

--header 'Authorization: Bearer YWhhbWwsdG9uQGFwaWdlZS5jb206bClwYXNzdzByZAo'

API-ключ создаётся в вашем аккаунте. Подробнее

Идентификация пользователей

В рамках API интеграции вы можете как самостоятельно назначать ID для конечных пользователей и сессий, так и использовать идентификаторы, выданные платформой.

1. Если идентификатор пользователя хранится на вашей стороне:

   • Передайте user.id и session.custom в запросе.
   • В качестве ID можно использовать внутренние идентификаторы пользователя и сессии. Для объединения профиля между каналами дополнительно отправляйте события login-v1 или signup-v1 с хешированным идентификатором.

2. Если идентификатор пользователя хранится на стороне платформы:

   • В первом запросе /ssapi/choose не передавайте user и session.
   • В первом запросе /ssapi/event передайте "user": {} и "session": {}.
   • Сохраните user.slid и session.sl, возвращённые в ответе.
   • Передавайте их с последующими запросами.