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.

Read the API docs Try TeamRetro free

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 związanych z Państwa procesami roboczymi. Wystarczy uwierzytelnić się za pomocą tokenu typu „bearer” i już mogą Państwo zacząć:

curl https://developer.teamretro.com/api/v1/actions \
  -H "Authorization: Bearer $TEAMRETRO_API_KEY"
Zapoznaj się z dokumentacją APIWolą Państwo czat? Proszę skorzystać z serwera MCP

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 oraz szacunków, a także z modelami stanu, aby wykorzystać te informacje w swoich raportach.

Eksport raportów

Pobierz pliki CSV — aktywność zespołów, działania, podsumowania retrospektyw i przeglądów stanu, kondycję zespołów oraz dane 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.

Poziom zespołu w każdym planie

Klucze o zasięgu zespołowym działają we wszystkich planach. Plan Enterprise zapewnia dostęp do kluczy obejmujących całe konto, kluczy międzyzespołowych oraz funkcji przydzielania uprawnień SCIM — zgodnie z tymi samymi zasadami, jakie obowiązują 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 natychmiast, gdy to nastąpi

Proszę nie przeprowadzać odpytywań. Wystarczy 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 ponownie lub zamknięta akcja, zmieni się umowa, 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

Skonfiguruj w sekcji Zespół → Ustawienia → Integracje. Wybierz zdarzenia, ustaw punkt końcowy, pobierz automatycznie wygenerowany klucz podpisujący i wyślij zdarzenie testowe.

Podpisane i możliwe do zweryfikowania

Każda dostawa zawiera sygnaturęX-TeamRetro-Signature(HMAC-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.

Zapoznaj się z przewodnikiem dotyczącym webhooków

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łna dokumentacja — obejmująca wszystkie zasoby, filtry i pola — znajduje się pod adresem developer.teamretro.com/docs.

Odpowiedzi na pytania

Kto może korzystać z tego interfejsu API?
Klucze API na poziomie zespołu są dostępne we wszystkich planach. Plan Enterprise oferuje dodatkowo klucze obowiązujące w całym koncie i we wszystkich zespołach oraz obsługę SCIM. Klucze można tworzyć i cofać w sekcji Ustawienia → API i SCIM.
Jak mogę się uwierzytelnić?
Każde żądanie zawiera nagłówekAuthorization: Bearer <key>. Klucze są przypisywane do zakresów Read, Write lub SCIM w momencie ich utworzenia i można je cofnąć w dowolnym momencie.
Webhooki czy odpytywanie?
Zalecamy korzystanie z webhooków — TeamRetro wysyła powiadomienie w momencie, gdy coś się wydarzy (zakończenie retrospektywy, utworzenie lub zamknięcie działania), dzięki czemu nie muszą Państwo przeprowadzać ciągłych zapytań. Każda wiadomość jest podpisana, co pozwala zweryfikować, czy pochodzi od nas.
Czy dostępna jest opcja AI / MCP?
Tak. Jeśli woli Pan/Pani pracować w języku naturalnym zamiast pisać kod, serwer TeamRetro MCP łączy Claude’a, ChatGPT i inne asystenty z tymi samymi danymi.
Gdzie można znaleźć pełną dokumentację API?
Pełna dokumentacja znajduje się pod adresem developer.teamretro.com/docs.

Bezpieczeństwo, zgodność z przepisami i kontrola na poziomie korporacyjnym

Firma TeamRetro posiada certyfikat SOC 2 typu 2 przyznany przez niezależnego audytora, który dokonał oceny naszych zasad, produktu, platformy oraz infrastruktury zgodnie ze standardem dotyczącym zleceń poświadczających (ASAE 3150).

ZŁÓŻ WNIOSEK O CERTYFIKAT SOC 2 PRZEZ TRUST CENTER POBIERZ SOC 3
SOC 2 Type 2 SOC 3

  • 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 użytkownikami

  • Dzienniki audytowe dostępne na żądanie

Zapewniamy dostępność na poziomie 99,9% oraz umowy SLA przewidujące szybką reakcję, aby zagwarantować Państwa zespołom nieprzerwaną produktywność i stałe wsparcie. Pulpit nawigacyjny stanu