Ce que vous allez configurer
- Une clé API personnelle Linear connectée à Elido - pas d'OAuth, pas d'enregistrement d'application.
- Des tickets Linear créés automatiquement quand le moniteur de liens cassés d'Elido trouve une destination qui ne fonctionne plus.
- Une équipe Linear cible par espace de travail Elido.
L'intégration Linear ouvre automatiquement un ticket quand Elido détecte un lien cassé : un lien court dont la destination renvoie une erreur ou ne répond plus. Le moniteur de liens cassés vérifie les liens une fois par jour.
Ce dont vous avez besoin
- Un compte Linear autorisé à créer des tickets dans l'équipe cible.
- Une clé API personnelle Linear (30 secondes pour la générer).
- Un rôle Elido autorisé à gérer les intégrations de l'espace de travail.
Générer une clé API Linear
- Allez dans Linear → Settings → API → Personal API keys.
- Cliquez sur Create key. Donnez-lui un label comme « Elido integration ».
- Copiez la clé. Linear ne l'affiche qu'une seule fois.
Configurer dans Elido
- Allez dans Dashboard → Integrations → Linear.
- Collez la clé API et validez-la. Elido liste toutes les équipes auxquelles votre clé donne accès.
- Sélectionnez l'équipe cible. Les tickets y seront créés.
- Enregistrez. La clé est stockée chiffrée.
Ce qui est écrit dans Linear
Quand un lien est détecté comme cassé pour la première fois (et à nouveau s'il l'est toujours 24 heures plus tard), Elido ouvre un ticket intitulé « Broken link: [short URL] ». Il contient :
- L'URL courte et l'URL de destination.
- Le code de statut HTTP et le message d'erreur, quand ils sont disponibles.
- L'heure à laquelle Elido a détecté le problème.
Elido ne crée qu'un seul ticket par détection et ne relit rien depuis Linear - il ne ferme pas les tickets et ne suit pas leur état. Cela relève du flux de travail de votre équipe.
Dépannage
« Not authorized » lors de la validation de la clé - La clé API est erronée ou a été révoquée. Régénérez-la depuis Linear Settings → API.
Tickets créés dans la mauvaise équipe - Vérifiez le choix de l'équipe dans Dashboard → Integrations → Linear. Si une clé a accès à plusieurs équipes, le sélecteur a peut-être choisi la première par défaut.
Aucun ticket créé - Seuls les liens cassés créent des tickets. Vérifiez que la connexion Linear apparaît comme connectée et n'a pas été révoquée.
Tickets en double - Elido ouvre au plus un ticket par détection. Si vous voyez des doublons, vérifiez que la même équipe Linear n'est pas connectée sous deux espaces de travail Elido.