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

У API-документации есть коллекция запросов с примерами. Вы можете просматривать ее без учетной записи Postman.

Если вы уже используете Postman, вы можете форкнуть и запустить коллекцию в Postman.

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

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

--header 'Authorization: Bearer YWhhbWwsdG9uQGFwaWdlZS5jb206bClwYXNzdzByZAo'

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

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

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

   • Передайте параметры user.custom и session.custom в запросе. В качестве ID вы можете использовать внутренний ID пользователя или SHA-256 хэш номера телефона или email.

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

   • Не передавайте в первом запросе параметры user и session.
   • Сохраните user.slid и session.sl, возвращаемый в ответе.
   • Передавайте их с последующими запросами.