Zautomatyzuj sesje retrospektywne, kontrole stanu i działania za pomocą interfejsu API TeamRetro
Interfejs API REST TeamRetro oraz webhooki umożliwiają automatyzację retrospektyw, kontroli stanu, działań i zespołów, a także przesyłanie zdarzeń bezpośrednio do Państwa własnych systemów. Rozwiązanie to zostało stworzone również z myślą o agentach opartych na sztucznej inteligencji.
Jeden interfejs API REST obejmujący retrospektywy, kontrole stanu, działania i zespoły
Włączaj podsumowania z serwisu Retro do swoich raportów, synchronizuj działania z narzędziem do śledzenia zadań, przydzielaj zespoły z systemu kadrowego – niezależnie od potrzeb Państwa procesu pracy. Wystarczy uwierzytelnić się za pomocą tokenu typu „bearer” i już można zaczynać:
curl https://developer.teamretro.com/api/v1/actions \
-H "Authorization: Bearer $TEAMRETRO_API_KEY"Co można zbudować
Zespoły i pracownicy
Proszę tworzyć listy zespołów, członków i ról oraz zarządzać nimi. Proszę dodawać użytkowników z Państwa własnych systemów.
Działania i porozumienia
Tworzenie, aktualizowanie i zamykanie działań; zapoznawanie się z umowami o współpracy oraz dbanie o ich przestrzeganie.
Spotkania i zdrowie
Proszę zapoznać się z metadanymi dotyczącymi analiz retrospektywnych, kontroli stanu, szacunków i Standupów, a także z modelami stanu, aby wykorzystać je w swoich raportach.
Eksport raportów
Prosimy o pobranie plików CSV zawierających dane dotyczące aktywności zespołów, działań, spotkań retrospektywnych i przeglądów stanu, kondycji zespołów oraz użytkowników.
Uwierzytelnianie i dostęp
Klucze nośnikowe, z zakresem
Proszę utworzyć klucze w sekcji Ustawienia → API i SCIM z zakresem uprawnień Odczyt, Zapis lub SCIM. Proszę przesłać je w formacie Authorization: Bearer <key>. W razie potrzeby proszę natychmiast cofnąć dowolny klucz.
Na poziomie zespołu w ramach każdego planu
Klucze o zasięgu zespołowym działają we wszystkich planach. Plany Business i Enterprise zapewniają dostęp do kluczy o zasięgu całego konta, międzyzespołowych, a także do funkcji przydzielania uprawnień za pomocą SCIM – zgodnie z tym samym podejściem, jakie stosujemy w przypadku analiz międzyzespołowych w ramach MCP. Właściciele organizacji mogą w dowolnym momencie wyłączyć dostęp do API i MCP dla całego konta.
Webhooki: dowiedzą się Państwo o tym natychmiast
Proszę nie przeprowadzać odpytań. Proszę skierować TeamRetro na punkt końcowy, a my prześlemy podpisane zdarzenie, gdy tylko nastąpi jakaś zmiana: zakończy się przegląd retro lub kontrola stanu, zostanie utworzona, przypisana innej osobie lub zamknięta akcja, zmieni się treść porozumienia, dołączy nowy członek lub ktoś zostanie @wspomniany.
{
"event": "action.completed",
"timestamp": "2026-06-09T10:30:00.000Z",
"data": { "action": { "id": "…", "title": "Fix flaky CI", "team": "Mobile" } }
}Na drużynę, w trybie samoobsługowym
Proszę skonfigurować tę opcję w sekcji Zespół → Ustawienia → Integracje. Proszę wybrać zdarzenia, ustawić punkt końcowy, pobrać automatycznie wygenerowany klucz podpisujący oraz wysłać zdarzenie testowe.
Podpisane i możliwe do zweryfikowania
Każda dostawa zawiera sygnaturę (X-TeamRetro-SignatureHMAC-SHA256) oraz unikalny identyfikator dostawy, co pozwala zweryfikować jej autentyczność oraz wyeliminować duplikaty.
Niezawodna dostawa
Wyłącznie protokół HTTPS, limit czasu wynoszący 30 sekund oraz automatyczne ponawianie prób (natychmiast, a następnie po 1 min, 5 min, 30 min i 2 godz.) przed wstrzymaniem działania nieprawidłowego punktu końcowego.
Stworzony również z myślą o agentach opartych na sztucznej inteligencji
Szybki start
Proszę wyświetlić listę otwartych działań zespołu, a następnie zamknąć jedno z nich:
# 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" }'Pełny opis, obejmujący wszystkie zasoby, filtry i pola, znajduje się pod adresem developer.teamretro.com/docs.
Najczęściej zadawane pytania
Kto może korzystać z API?
Jak mogę się uwierzytelnić?
Authorization: Bearer <key>nagłówek. Klucze mają zakres Odczyt, Zapis lub SCIM w momencie ich utworzenia i można je w każdej chwili unieważnić.Webhooki czy odpytywanie?
Czy dostępna jest opcja AI / MCP?
Gdzie można znaleźć pełną dokumentację API?
Bezpieczeństwo, zgodność z przepisami i kontrola na poziomie korporacyjnym
Firma TeamRetro posiada raport SOC 2 typu 2. Niezależny audytor zbadał mechanizmy kontroli w zakresie naszych zasad, produktów, platformy i infrastruktury zgodnie ze standardami poświadczania AICPA. Zapoznaj się z TeamRetro dla przedsiębiorstw.
Zgodność z RODO i hosting regionalny (USA i UE)
Jednokrotne logowanie (SSO) za pośrednictwem protokołu SAML
SCIM jako rozwiązanie umożliwiające skalowalne zarządzanie kontami użytkowników
Rejestry audytowe udostępniane na żądanie
Zapewniamy dostępność na poziomie 99,99% oraz umowy SLA przewidujące szybką reakcję, aby zagwarantować Państwa zespołom nieprzerwaną produktywność i wsparcie.Poznaj rozwiązania dla przedsiębiorstw