백엔드
오픈마켓 여행 플랫폼의 실전 API 연동 노하우
두줄요약
여행 플랫폼의 복잡한 API 연동에서 상세 페이지는 내결함성을, 실시간 예약은 최종 일관성과 멱등성을 중점으로 다뤘습니다. 타임아웃, fallback, 상태머신, 대사배치, 재시도와 보상 트랜잭션 같은 실전 대응 방법도 소개했습니다.
문제 상황
- 여행 플랫폼, 커머스 시스템, OTA 서버가 얽힌 복잡한 API 연동 구조
- 상세 페이지는 다수의 API 실패를 흡수해야 하고, 실시간 예약은 금전 거래와 상태 동기화가 핵심
해결 방법
- 중요도와 평균 응답시간을 기준으로 API별 타임아웃을 다르게 설정
- CircuitBreaker fallback으로 일부 API 오류 시 기본값 응답 제공
- 상태머신과 대사배치로 예약 상태를 재연동하고, 멱등성 고려한 재시도와 보상 트랜잭션 적용
주의할 점
- 중복 요청과 타임아웃으로 인해 클라이언트 에러와 서버 정상 처리 상태가 엇갈릴 수 있음
- 롤백이 어려운 외부 연동과 금전 관련 요청은 가장 나중에 배치하는 편이 유리
적용해볼 점
- API 중요도에 따라 timeout, retry, fallback 정책을 분리
- 예약·주문 상태를 명시적으로 정의한 뒤 상태머신으로 동기화