배달대행사 API 연동과 장애 대응 - 오늘드림 서비스 개발기

올리브영의 즉시 배송 서비스인 오늘드림은 외부 배달대행사와의 긴밀한 API 연동을 통해 운영된다. 연동은 올리브영이 배달을 요청하는 '주문 접수 API'와 배달대행사가 배송 상태를 업데이트하는 '콜백 API' 두 단계로 이루어진다.

주문 접수 시 발생할 수 있는 Read Timeout이나 Connection Timeout 같은 일시적 에러는 내부적으로 재시도를 수행한다. 특히 Timeout 발생 시 발생할 수 있는 중복 주문 문제를 방지하기 위해, 배달대행사의 중복 접수 응답(409 Conflict) 기능을 활용하여 데이터 정합성을 유지한다.

또한, 배달대행사가 늘어남에 따라 관리 포인트가 증가하는 문제를 해결하기 위해 콜백 API 리뉴얼을 진행했다. 각 대행사별로 파편화되어 있던 API를 하나로 통합하여, 기능 수정 시 발생할 수 있는 누락을 방지하고 유지보수 효율성을 높였다.