API를 통해 다른 시스템과 소통하는 경험에 대해 이야기해 줄 수 있나요?

팀 프로젝트에서 외부 결제 API와 처음으로 연동하는 작업을 담당했습니다. REST API 통신에서 가장 먼저 배운 건 응답 코드만 보는 게 아니라 에러 응답의 상세 메시지도 파싱해서 처리해야 한다는 것이었습니다. 타임아웃과 재시도 처리가 빠진 첫 구현에서는 외부 서버가 느려지면 우리 서비스도 같이 멈추는 문제가 생겼습니다. 이후에는 연결 타임아웃과 읽기 타임아웃을 분리해서 설정하고 일시적 실패는 지수 백오프로 재시도하는 방식을 배웠습니다. 다른 프로토콜 경험으로는 gRPC를 써보면서 스키마 정의와 타입 안전성이 REST보다 강하게 보장되는 경험을 했습니다. API 연동에서는 명세 문서와 실제 동작이 다른 경우가 생각보다 많아서 직접 테스트해보는 과정이 중요하다는 걸 배웠습니다.

API를 통한 시스템 연동은 내 코드보다 상대 시스템의 장애 시나리오를 어떻게 처리하느냐가 핵심이라는 걸 배웠습니다.