Cosa configurerai
- Una chiave API personale di Linear collegata a Elido: niente OAuth, nessuna registrazione di app.
- Issue Linear create automaticamente quando il monitor dei link non funzionanti di Elido trova una destinazione che non risponde più.
- Un team Linear di destinazione per ogni workspace Elido.
L'integrazione con Linear apre automaticamente una issue quando Elido rileva un link non funzionante: un link breve la cui destinazione restituisce un errore o smette di rispondere. Il monitor dei link non funzionanti controlla i link una volta al giorno.
Cosa ti serve
- Un account Linear con il permesso di creare issue nel team di destinazione.
- Una chiave API personale di Linear (si genera in 30 secondi).
- Un ruolo Elido che possa gestire le integrazioni nel workspace.
Generare una chiave API di Linear
- Vai su Linear → Settings → API → Personal API keys.
- Fai clic su Create key. Dagli un'etichetta come "Elido integration".
- Copia la chiave. Linear la mostra una sola volta.
Configurare in Elido
- Vai su Dashboard → Integrations → Linear.
- Incolla la chiave API e convalidala. Elido elenca tutti i team a cui la tua chiave ha accesso.
- Seleziona il team di destinazione. Le issue verranno create lì.
- Salva. La chiave viene memorizzata cifrata.
Cosa viene scritto in Linear
Quando un link viene rilevato per la prima volta come non funzionante (e di nuovo se è ancora non funzionante dopo 24 ore), Elido apre una issue intitolata "Broken link: [short URL]". Contiene:
- L'URL breve e l'URL di destinazione.
- Il codice di stato HTTP e il messaggio di errore, quando disponibili.
- L'ora in cui Elido ha rilevato il problema.
Elido crea una sola issue per rilevamento e non legge nulla da Linear: non chiude le issue e non ne segue lo stato. Questo dipende dal flusso di lavoro del tuo team.
Risoluzione dei problemi
"Not authorized" durante la convalida della chiave - La chiave API è errata o è stata revocata. Rigenerala da Linear Settings → API.
Issue che compaiono nel team sbagliato - Verifica la selezione del team in Dashboard → Integrations → Linear. Se una chiave ha accesso a più team, il selettore potrebbe aver scelto il primo per impostazione predefinita.
Nessuna issue creata - Solo i link non funzionanti creano issue. Controlla che la connessione a Linear risulti attiva e non sia stata revocata.
Issue duplicate - Elido apre al massimo una issue per rilevamento. Se vedi dei duplicati, controlla che lo stesso team Linear non sia collegato a due workspace Elido.