API 연동 실패와 재시도

API 연동 실패와 재시도는 통신이 불안정할 때 데이터와 작업을 안전하게 복구하는 운영 정책이다. 실패 메시지가 나와도 상대 시스템은 이미 요청을 처리했을 수 있어 무조건 같은 요청을 반복하면 문제가 생길 수 있다.

읽기와 변경 요청 구분

API로 정보를 읽는 경우와 가격·예약 등을 변경하는 경우는 영향이 다르다. 요청 결과를 확인할 수 없는 상태를 실패 확정과 구분한다.

• 요청 시간 초과와 서버 오류
• 이미 처리됐는지 확인할 수 있는 방법
• 중복 요청을 구분하는 식별 정보
• 재시도 간격과 종료 조건
• 오래된 결과의 적용 방지

중복 방지 기능은 상대 시스템의 지원과 계약을 확인한다.

표시 정책과 연결

정보 갱신 시각 표시로 오래된 정보가 정상처럼 보이지 않게 한다. 실패 시 마지막 값을 유지할지 장애 대체 콘텐츠로 바꿀지 정한다.

연결이 복구됐다고 모든 장치가 동시에 반복 요청하지 않도록 한다. 서버의 요청 제한과 안내 조건을 존중하고 최신 버전과 적용 순서를 확인한다.

구매 검증

통신 단절, 늦은 응답, 중복 응답을 시스템 부하 시험에서 재현한다. POS 연동은 가격과 재고가 서로 다른 시점의 자료로 섞이지 않는지도 확인한다.

장애 기록과 원인 추적에 요청 식별자와 결과를 남기되 불필요한 접근 정보를 노출하지 않는다. 구매 시 오류 표시, 복구 방식, 지원 담당의 범위를 정한다.

병원 호출 정보의 화면 적용에서는 늦게 도착한 이전 호출이 새 호출을 덮어쓰지 않도록 순서를 검증한다.