API Толк

Для работы с API вам понадобится ключ.

API ключ — идентификатор зарегистрированного приложения в пространстве Контур Толк.

Все отправляемые запросы, содержащие данный код будут ассоциированы с приложением.

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

• Отключение учетных записей уволенных сотрудников.
• Автоматическое создание конференций с нужными настройками.
• Автоматизация загрузки и анализа посещаемости сервиса.

Управление приложением и ключами

Управлять API кодом могут все администраторы пространства в панели администрирования. Там вы можете создавать нужные ключи, определять ограничения для них, устанавливать срок действия.

Для каждого связки  доступны следующие области его действия

Доступные области:

• Пользователи
• Комнаты
• Календари
• Отчеты

На каждую область действия доступа можно выдать следующие разрешения:

• Только чтение
• Чтение и изменение

При создании ключа в описании укажите для каких целей создает его и кто является ответственным за его использование.

Использование ключа

После создания API ключа, Толк будет отображать его в течение часа. Вам необходимо надежно сохранить код для дальнейшего использования.

Вся коммуникация происходит по протоколу HTTP.

Для выполнения запросов от имени приложения передайте API-ключ в HTTP-заголовке запроса X-Auth-Token

Чтобы обеспечить безопасность данных:

1. Не встраивайте ключи непосредственно в код вашего приложения.
2. Периодически обновляйте коды интеграции.
3. Удаляйте ключи, которые вы не используете.

Ограничения на запросы к API

Для защиты от перегрузки установлены квоты на количество запросов к API в рамках одного пространства (ограничения определяются вашим тарифом).

В случае превышения лимита вы получите ответ Status: 429 Too Many Requests. Рекомендуем учитывать ограничения при интеграции.

Вас интересует сервис? Заполните данные и мы перезвоним