Что вы настроите
- Персональный API-ключ Linear, подключённый к Elido: без OAuth и регистрации приложения.
- Автоматически создаваемые задачи в Linear, когда монитор битых ссылок Elido находит назначение, которое перестало работать.
- Одну целевую команду Linear на рабочее пространство Elido.
Интеграция с Linear автоматически открывает задачу, когда Elido обнаруживает битую ссылку: короткую ссылку, назначение которой возвращает ошибку или перестало отвечать. Монитор битых ссылок проверяет ссылки раз в сутки.
Что вам понадобится
- Учётная запись Linear с правом создавать задачи в целевой команде.
- Персональный API-ключ Linear (создаётся за 30 секунд).
- Роль в Elido, позволяющая управлять интеграциями в рабочем пространстве.
Создайте API-ключ Linear
- Откройте Linear → Settings → API → Personal API keys.
- Нажмите Create key. Дайте ему название, например «Elido integration».
- Скопируйте ключ. Linear показывает его только один раз.
Настройка в Elido
- Откройте Dashboard → Integrations → Linear.
- Вставьте API-ключ и проверьте его. Elido покажет все команды, к которым у вашего ключа есть доступ.
- Выберите целевую команду. Задачи будут создаваться в ней.
- Сохраните. Ключ хранится в зашифрованном виде.
Что записывается в Linear
Когда ссылка впервые определена как битая (и повторно, если она остаётся битой через 24 часа), Elido открывает одну задачу с заголовком «Broken link: [короткий URL]». В ней указано:
- Короткий URL и целевой URL.
- HTTP-код статуса и сообщение об ошибке, если они доступны.
- Время, когда Elido обнаружил проблему.
Elido создаёт только одну задачу на одно обнаружение и ничего не читает из Linear: он не закрывает задачи и не отслеживает их состояние. Это остаётся на усмотрение рабочего процесса вашей команды.
Устранение неполадок
«Not authorized» при проверке ключа - API-ключ неверен или отозван. Создайте новый в Linear Settings → API.
Задачи появляются не в той команде - Проверьте выбор команды в Dashboard → Integrations → Linear. Если у ключа есть доступ к нескольким командам, выбор мог по умолчанию остановиться на первой.
Задача не создана - Задачи создают только битые ссылки. Убедитесь, что подключение к Linear отображается как активное и не было отозвано.
Дубликаты задач - Elido открывает не более одной задачи на одно обнаружение. Если вы видите дубликаты, проверьте, не подключена ли одна и та же команда Linear в двух рабочих пространствах Elido.