Авторизация и API-ключи
Выпустить и отозвать ключ
- Войдите в Heth и откройте Бизнес.
- Перейдите к интеграции кнопкой Подключить.
- На экране Интеграция по АПИ нажмите + для выпуска ключа.
- Сохраните ключ как секрет серверной интеграции.
- Для отзыва удалите запись ключа на этом экране. При замене обновите настройки интеграции.
Не используйте ключ из скриншота или примера документации. Вместо действующих реквизитов здесь используются placeholders.
Заголовки запроса
| Заголовок | Применение |
|---|---|
x-api-key | Обязателен для авторизации API-ключом |
Content-Type: application/json | Обязателен при отправке JSON |
Для https://app.heth.me контекст организации подставляет шлюз Heth. Это правило относится к указанному хосту и не переносится на произвольный API платформы. Ключ привязан к собственному аккаунту и его правам.
Ключ и пользовательская сессия различаются
Транзакционная интеграция принимает API-ключ. Интерактивные функции могут требовать Bearer-сессию вошедшего пользователя: ключ не открывает автоматически кошельки, профиль, @имена и все бизнес-функции. Клиентские сессии подписок — отдельный вид авторизации. Не заменяйте один тип токена другим и не копируйте seed в конфигурацию интеграции.
См. доступные функции и ошибки. Запрашивайте только необходимый для задачи доступ.