Was Sie einrichten
- Ein persönlicher Linear-API-Key, mit Elido verbunden - kein OAuth, keine App-Registrierung.
- Automatisch erstellte Linear-Issues, wenn der Broken-Link-Monitor von Elido ein Ziel findet, das nicht mehr funktioniert.
- Ein Ziel-Team in Linear pro Elido-Workspace.
Die Linear-Integration öffnet automatisch ein Issue, wenn Elido einen defekten Link erkennt: einen Kurzlink, dessen Ziel einen Fehler liefert oder nicht mehr antwortet. Der Broken-Link-Monitor prüft Links einmal täglich.
Was Sie brauchen
- Ein Linear-Konto mit der Berechtigung, im Ziel-Team Issues zu erstellen.
- Einen persönlichen Linear-API-Key (in 30 Sekunden erzeugt).
- Eine Elido-Rolle, die Integrationen im Workspace verwalten darf.
Einen Linear-API-Key erzeugen
- Gehen Sie zu Linear → Settings → API → Personal API keys.
- Klicken Sie auf Create key. Vergeben Sie ein Label wie „Elido integration“.
- Kopieren Sie den Key. Linear zeigt ihn nur einmal an.
In Elido konfigurieren
- Gehen Sie zu Dashboard → Integrations → Linear.
- Fügen Sie den API-Key ein und validieren Sie ihn. Elido listet alle Teams auf, auf die Ihr Key Zugriff hat.
- Wählen Sie das Ziel-Team. Dort werden die Issues erstellt.
- Speichern Sie. Der Key wird verschlüsselt gespeichert.
Was nach Linear geschrieben wird
Wird ein Link erstmals als defekt erkannt (und erneut, wenn er 24 Stunden später immer noch defekt ist), öffnet Elido ein Issue mit dem Titel „Broken link: [short URL]“. Es enthält:
- Die Kurz-URL und die Ziel-URL.
- Den HTTP-Statuscode und die Fehlermeldung, sofern verfügbar.
- Den Zeitpunkt, zu dem Elido das Problem erkannt hat.
Elido erstellt pro Erkennung nur ein Issue und liest nichts aus Linear zurück - es schließt keine Issues und verfolgt keinen Issue-Status. Das bleibt dem Workflow Ihres Teams überlassen.
Fehlerbehebung
„Not authorized“ beim Validieren des Keys - Der API-Key ist falsch oder wurde widerrufen. Erzeugen Sie ihn in Linear unter Settings → API neu.
Issues erscheinen im falschen Team - Prüfen Sie die Team-Auswahl unter Dashboard → Integrations → Linear. Hat ein Key Zugriff auf mehrere Teams, hat die Auswahl möglicherweise standardmäßig das erste gewählt.
Kein Issue erstellt - Nur defekte Links erzeugen Issues. Prüfen Sie, ob die Linear-Verbindung als verbunden angezeigt wird und nicht widerrufen wurde.
Doppelte Issues - Elido öffnet höchstens ein Issue pro Erkennung. Sehen Sie Duplikate, prüfen Sie, ob dasselbe Linear-Team nicht unter zwei Elido-Workspaces verbunden ist.