Połączyć systemy, nie tracąc kontroli nad danymi
Dobre API ocenia się nie tylko wtedy, gdy wszystko działa. Ocenia się je przede wszystkim wtedy, gdy zdalna usługa zwalnia, wysyła dwa razy to samo zdarzenie lub staje się niedostępna.
Przewidzieć sytuacje awaryjne
W zależności od krytyczności przepływu przewidujemy uwierzytelnianie, walidację, idempotencję, ponawianie, logi i obsługę błędów.
Integracja musi być obserwowalna
Musi być możliwe udzielenie odpowiedzi na proste pytania:
- co wysłaliśmy?
- co otrzymaliśmy i kiedy?
- dlaczego operacja się nie powiodła?
- czy można ją powtórzyć bez tworzenia duplikatu?
Te informacje znacznie skracają czas diagnozy na produkcji.
Systemy do połączenia?
Prosimy wymienić programy, które mają wymieniać dane – wskażemy krytyczne przepływy i scenariusze awarii.