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 vi 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, assegnate i team dal vostro sistema HR — qualunque siano le esigenze del vostro flusso di lavoro. Effettuate l’autenticazione con un token bearer e il gioco è fatto:
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 alle analisi retrospettive, alle verifiche dello stato di salute e alle stime, oltre ai modelli di salute, per alimentare i Suoi report.
Esportazioni di report
Scaricare i file CSV di esportazione: attività del team, attività relative alle azioni, attività relative alle sessioni di retrospettiva e di verifica dello stato di salute, stato di salute del team e utenti.
Autenticazione e accesso
Chiavi al portatore, con ambito
Creare le chiavi nella sezione 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 funzionano su tutti i piani. Il piano Enterprise sblocca le chiavi a livello di account e tra team, oltre al provisioning SCIM — la stessa linea di demarcazione che tracciamo per le 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 codice segreto di firma generato automaticamente e inviare un evento di prova.
Firmato e verificabile
Ogni consegna è accompagnata da unX-TeamRetro-Signature (HMAC-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 (immediato, poi 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
Elencare le azioni aperte di una squadra, quindi chiuderne 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" }'La documentazione completa — che comprende tutte le risorse, i filtri e i campi — è disponibile all’indirizzo developer.teamretro.com/docs.
Domande e risposte
Chi può utilizzare l'API?
Come si effettua l'autenticazione?
Authorization: Bearer <key>un’intestazione. Al momento della creazione, alle chiavi vengono assegnati i livelli di autorizzazione 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 ha ottenuto la certificazione SOC 2 Tipo 2 da parte di un revisore indipendente che ha valutato le nostre politiche, il nostro prodotto, la nostra piattaforma e la nostra infrastruttura in conformità con lo Standard on Assurance Engagements (ASAE 3150).
-
Conformità al GDPR e hosting regionale (Stati Uniti e UE)
-
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,9%, con SLA che prevedono tempi di risposta rapidi per assicurare che i vostri team rimangano produttivi e ricevano il supporto necessario. Pannello di controllo dello stato