## Коллекция запросов
У API-документации есть [коллекция запросов с примерами](https://openapi-v1.gravityfield.ai).

---

## Авторизация
Это API использует авторизацию [bearer authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication#bearer), используя ключ API для вашего проекта.

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

```
--header 'Authorization: Bearer YWhhbWwsdG9uQGFwaWdlZS5jb206bClwYXNzdzByZAo'
```
API-ключ создаётся в вашем аккаунте. [Подробнее](./manage_api_keys.md)

--- 

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

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

2. Если идентификатор пользователя хранится на стороне платформы:
    - Не передавайте в первом запросе параметры `user` и `session`. 
    - Сохраните `user.slid` и `session.sl`, возвращаемый в ответе.
    - Передавайте их с последующими запросами.
    
!!!
В случае гибридной интеграции возможно использовать `choose`-запрос с пустым селектором для получения актуальных значений `user.slid` и `session.sl`
!!!