INTEGRATION / API

Integracja API na produkcji: checklista timeoutów, retry, idempotencji i obsługi błędów.

Połączenie działa nie wtedy, gdy jeden request zwróci 200, lecz wtedy, gdy system ma przewidywalne zachowanie również przy duplikacie, timeout, limicie i częściowej awarii dostawcy.

1. Ustal source of truth

Jeżeli dwa systemy mogą edytować ten sam stan, trzeba ustalić priorytet i sposób rozwiązywania konfliktów. Bez tego synchronizacja tworzy trudne do odtworzenia błędy biznesowe.

2. Timeout i retry muszą być celowe

Automatyczne ponawianie operacji zapisu bez idempotencji może utworzyć duplikaty. Retry powinien zależeć od typu błędu i charakteru operacji.

3. Waliduj odpowiedź, nie tylko status

HTTP 200 nie gwarantuje, że dane mają oczekiwaną strukturę lub znaczenie. Kontrakt integracji powinien definiować wymagane pola i obsługę zmian schematu.

4. Zaprojektuj obserwowalność i ręczny fallback

Dla istotnego procesu trzeba móc ustalić, która operacja nie przeszła, z jakiego powodu i jak bezpiecznie ją powtórzyć lub dokończyć ręcznie.

NASTĘPNY KROK / PROJEKT

Potrzebujesz przełożyć tę wiedzę na konkretną stronę?

Opisz projekt