Для работы с API вам понадобится ключ.
API ключ — идентификатор зарегистрированного приложения в пространстве Контур Толк.
Все отправляемые запросы, содержащие данный ключ будут ассоциированы с приложением.
Управлять API ключами могут все администраторы пространства в разделе «API ключи» панели администрирования. Там вы можете создавать нужные ключи, определять ограничения для них, устанавливать срок действия.
Для каждого API ключа доступны следующие области его действия
На каждую область действия API ключа можно выдать следующие разрешения:
При создании ключа в описании укажите для каких целей создает ключ и кто является ответственным за его использование.
После создания API ключа, Толк будет отображать его в течении часа. Вам необходимо надежно сохранить его для дальнейшего использования.
Вся коммуникация происходит по протоколу HTTP. Для выполнения запросов от имени приложения передайте API-ключ в HTTP-заголовке запроса X-Auth-Token
Чтобы обеспечить безопасность ключей:
Для защиты от перегрузки установлены квоты на количество запросов к API в рамках одного пространства (ограничения определяются вашим тарифом).
В случае превышения лимита вы получите ответ Status: 429 Too Many Requests. Рекомендуем учитывать ограничения при интеграции.