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 rozpocząć pracę:

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

Prosimy o zapoznanie się z metadanymi dotyczącymi analiz retrospektywnych, kontroli stanu technicznego i szacunków, a także z modelami stanu technicznego, które posłużą Państwu do sporządzania raportów.

Eksport raportów

Proszę pobrać pliki CSV zawierające dane dotyczące aktywności zespołu, działań, spotkań retrospektywnych i kontroli stanu, kondycji zespołu oraz użytkowników.

Uwierzytelnianie i dostęp

Klucze nośnikowe, ograniczone 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 każdym planie

Klucze o zakresie zespołowym działają we wszystkich planach. Plan Enterprise zapewnia dostęp do kluczy obowiązujących w całym koncie, kluczy międzyzespołowych oraz funkcji przydzielania uprawnień SCIM – podobnie jak w przypadku wglądu w dane międzyzespołowe za pośrednictwem 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ć sondaży. Prosimy o skierowanie TeamRetro na punkt końcowy, a my prześlemy podpisane powiadomienie, 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ę 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

Proszę skonfigurować tę funkcję 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ć zduplikowane dane.

Niezawodna dostawa

Wyłącznie protokół HTTPS, limit czasu wynoszący 30 sekund oraz automatyczne ponowne próby (natychmiastowe, a następnie po 1 min, 5 min, 30 min i 2 godz.) przed wstrzymaniem działania nieudanej końcówki.

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.

Najczęściej zadawane pytania

Kto może korzystać z 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, niezależnie od zespołów, oraz obsługę SCIM. Klucze można tworzyć i cofać w sekcji Ustawienia → API i SCIM.
Jak mogę się uwierzytelnić?
Każde żądanie zawiera Authorization: Bearer <key>nagłówek. Klucze mają zakres Odczyt, Zapis lub SCIM w momencie ich utworzenia i można je w dowolnym momencie unieważnić.
Webhooki czy odpytywanie?
Zalecamy korzystanie z webhooków. TeamRetro wysyła powiadomienie w momencie, gdy coś się dzieje (zakończenie sesji retro, utworzenie lub zamknięcie zadania), dzięki czemu nie muszą Państwo przeprowadzać 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 treść dokumentu 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ń zapewnienia jakości (ASAE 3150).

SOC 2 Type 2SOC 3
  • Zgodność z rozporządzeniem RODO oraz hosting regionalny (USA i UE)

  • Jednokrotne logowanie (SSO) za pośrednictwem protokołu SAML

  • SCIM jako rozwiązanie umożliwiające skalowalne przyznawanie uprawnień użytkownikom

  • Rejestry audytowe dostępne na żądanie

Zapewniamy dostępność na poziomie 99,99% oraz umowy SLA przewidujące szybką reakcję, aby Państwa zespoły mogły zachować wydajność i liczyć na nasze wsparcie.Pulpit nawigacyjny stanu