API-ключи

Вкладка «API Ключи» — последняя в «Администрировании». Здесь выдаются ключи для внешних интеграций, которые обращаются к заявкам через HTTP-запросы. Сам REST API разобран отдельно, в статье «REST API».

Что такое ключ

Ключ выдаётся не «вообще», а на конкретную учётную запись — и по правам полностью повторяет то, что может сам этот пользователь в пределах своей группы. Ключ, выданный на исполнителя, может через API то же, что этот исполнитель может в интерфейсе; ключ на обычного пользователя — только то, что доступно ему, например создавать заявки.

Список выданных API-ключей: пользователь, роль, группа, срок действия

Важно: только один ключ может быть выдан на учётную запись.

Создание ключа

При создании нужно выбрать, на какого пользователя выдаётся ключ.

Форма создания ключа: выбор пользователя и срок действия

Можно ограничить срок действия конкретной датой — по её истечении ключ автоматически перестаёт работать. Если ограничение не ставить, ключ действует бессрочно.

Важно: сам ключ показывается только один раз, сразу после создания. Отредактировать существующий ключ нельзя — если он утерян или скомпрометирован, его нужно удалить и выпустить новый.

Что дальше

Как использовать ключ в запросах и что умеет API — в статье «REST API».