Co skonfigurujesz
- Osobisty klucz API Linear połączony z Elido - bez OAuth i rejestracji aplikacji.
- Automatycznie tworzone zgłoszenia Linear, gdy monitor uszkodzonych linków Elido znajdzie adres docelowy, który już nie działa.
- Jeden docelowy zespół Linear na każdy workspace Elido.
Integracja z Linear automatycznie otwiera zgłoszenie, gdy Elido wykryje uszkodzony link: krótki link, którego adres docelowy zwraca błąd lub przestaje odpowiadać. Monitor uszkodzonych linków sprawdza linki raz dziennie.
Czego potrzebujesz
- Konta Linear z uprawnieniem do tworzenia zgłoszeń w docelowym zespole.
- Osobistego klucza API Linear (wygenerujesz go w 30 sekund).
- Roli w Elido, która może zarządzać integracjami w workspace'ie.
Wygeneruj klucz API Linear
- Przejdź do Linear → Settings → API → Personal API keys.
- Kliknij Create key. Nadaj mu etykietę, np. „Elido integration”.
- Skopiuj klucz. Linear pokazuje go tylko raz.
Konfiguracja w Elido
- Przejdź do Dashboard → Integrations → Linear.
- Wklej klucz API i zweryfikuj go. Elido wyświetli wszystkie zespoły, do których Twój klucz ma dostęp.
- Wybierz docelowy zespół. Zgłoszenia będą tworzone właśnie tam.
- Zapisz. Klucz jest przechowywany w postaci zaszyfrowanej.
Co jest zapisywane w Linear
Gdy link zostanie po raz pierwszy wykryty jako uszkodzony (oraz ponownie, jeśli po 24 godzinach nadal jest uszkodzony), Elido otwiera jedno zgłoszenie zatytułowane „Broken link: [short URL]”. Zawiera ono:
- Krótki adres URL i adres docelowy.
- Kod statusu HTTP i komunikat o błędzie, jeśli są dostępne.
- Czas wykrycia problemu przez Elido.
Elido tworzy tylko jedno zgłoszenie na wykrycie i niczego nie odczytuje z Linear - nie zamyka zgłoszeń ani nie śledzi ich stanu. To zależy od przepływu pracy Twojego zespołu.
Rozwiązywanie problemów
„Not authorized” podczas weryfikacji klucza - Klucz API jest błędny lub został unieważniony. Wygeneruj go ponownie w Linear Settings → API.
Zgłoszenia pojawiają się w złym zespole - Sprawdź wybór zespołu w Dashboard → Integrations → Linear. Jeśli klucz ma dostęp do wielu zespołów, selektor mógł domyślnie wybrać pierwszy.
Nie utworzono zgłoszenia - Zgłoszenia tworzą tylko uszkodzone linki. Sprawdź, czy połączenie z Linear jest aktywne i nie zostało unieważnione.
Zduplikowane zgłoszenia - Elido otwiera co najwyżej jedno zgłoszenie na wykrycie. Jeśli widzisz duplikaty, sprawdź, czy ten sam zespół Linear nie jest połączony z dwoma workspace'ami Elido.