Automatizzate le sessioni di retrospettiva, i controlli di integrità e le azioni con l’API di TeamRetro
L'API REST e i webhook di TeamRetro consentono di automatizzare retrospettive, controlli di integrità, azioni e team, nonché di inviare gli eventi direttamente ai vostri sistemi. Progettati anche per gli agenti basati sull'intelligenza artificiale.
Un’unica API REST per retrospettive, controlli di integrità, azioni e team
Inserite i riepiloghi retrospettivi nei vostri report, sincronizzate le azioni con il vostro sistema di monitoraggio, gestite i team dal vostro sistema HR: qualunque siano le esigenze del vostro flusso di lavoro. Effettuate l’autenticazione con un token bearer e siete pronti a partire:
curl https://developer.teamretro.com/api/v1/actions \
-H "Authorization: Bearer $TEAMRETRO_API_KEY"Cosa potete realizzare
Team e persone
Elencare e gestire i team, i membri e i ruoli. Effettuare il provisioning degli utenti dai propri sistemi.
Azioni e accordi
Creare, aggiornare e chiudere le azioni; leggere e mantenere gli accordi di lavoro.
Riunioni e salute
Legga i metadati relativi a analisi retrospettive, controlli di integrità, stime e Standup, oltre ai modelli di integrità, per alimentare i Suoi report.
Esportazioni dei report
Scaricate i file CSV relativi alle attività del team, alle azioni, alle sessioni di retrospettiva e di verifica dello stato di salute, allo stato di salute del team e agli utenti.
Autenticazione e accesso
Chiavi al portatore, con ambito
Creare le chiavi in Impostazioni → API e SCIM con ambito Lettura, Scrittura o SCIM. Inviarle come Authorization: Bearer <key>. Revocare qualsiasi chiave non appena necessario.
A livello di team in ogni piano
Le chiavi a livello di team sono disponibili su tutti i piani. I piani Business ed Enterprise consentono l’utilizzo di chiavi a livello di account e tra team, oltre al provisioning SCIM, in linea con la nostra politica relativa alle analisi tra team tramite MCP. I titolari dell’organizzazione possono disabilitare l’accesso alle API e a MCP per l’intero account in qualsiasi momento.
Webhook: venite a sapere immediatamente quando si verifica un evento
Non effettuate il polling. Indirizzate TeamRetro verso un endpoint e invieremo un evento firmato non appena si verificherà un cambiamento: il completamento di un retro o di un controllo di integrità, la creazione, la riassegnazione o la chiusura di un’azione, la modifica di un accordo, l’adesione di un membro o la menzione di qualcuno con @.
{
"event": "action.completed",
"timestamp": "2026-06-09T10:30:00.000Z",
"data": { "action": { "id": "…", "title": "Fix flaky CI", "team": "Mobile" } }
}Per ogni squadra, in modalità self-service
Configurare la funzione in Team → Impostazioni → Integrazioni. Selezionare gli eventi, impostare il proprio endpoint, ottenere un segreto di firma generato automaticamente e inviare un evento di prova.
Firmato e verificabile
Ogni consegna è accompagnata da un (X-TeamRetro-SignatureHMAC-SHA256) e da un ID di consegna univoco, in modo da poter verificarne l’autenticità ed eliminare i duplicati.
Consegna affidabile
Solo HTTPS, timeout di 30 secondi e tentativi automatici di ricollegamento (immediato, poi dopo 1 minuto, 5 minuti, 30 minuti e 2 ore) prima che un endpoint non funzionante venga messo in pausa.
Progettato anche per gli agenti di intelligenza artificiale
Guida rapida
Elenchi le azioni aperte di una squadra, quindi ne chiuda una:
# Find open actions for a team
curl "https://developer.teamretro.com/api/v1/actions?status=open" \
-H "Authorization: Bearer $TEAMRETRO_API_KEY"
# Mark an action complete
curl -X PATCH https://developer.teamretro.com/api/v1/actions/$ACTION_ID \
-H "Authorization: Bearer $TEAMRETRO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "status": "completed" }'Il riferimento completo, che comprende tutte le risorse, i filtri e i campi, è disponibile all’indirizzo developer.teamretro.com/docs.
Domande frequenti
Chi può utilizzare l'API?
Come si effettua l'autenticazione?
Authorization: Bearer <key>. Al momento della creazione, alle chiavi viene assegnato un ambito Lettura, Scrittura o SCIM e possono essere revocate in qualsiasi momento.Webhook o polling?
Esiste un'opzione AI / MCP?
Dove si trova la documentazione completa dell'API?
Sicurezza, conformità e controllo di livello aziendale
TeamRetro è in possesso di un rapporto SOC 2 di Tipo 2. Un revisore indipendente ha esaminato i controlli relativi alle nostre politiche, ai nostri prodotti, alla nostra piattaforma e alla nostra infrastruttura in conformità con gli standard di attestazione dell’AICPA. Scoprite TeamRetro per le aziende.
Conformità al GDPR e hosting regionale (Stati Uniti e Unione Europea)
Accesso unico (SSO) tramite SAML
SCIM per la gestione scalabile degli utenti
Registri di audit disponibili su richiesta
Garantiamo un tempo di attività del 99,99%, con SLA che prevedono tempi di risposta rapidi per assicurare che i Suoi team rimangano produttivi e ricevano il supporto necessario.Scoprite il mondo delle imprese