오래 걸리는 API 작업에 진행 상태와 취소 기준 만들기

대량 데이터 생성이나 보고서 출력이 오래 걸리면 사용자는 응답이 멈췄다고 생각해 요청을 반복할 수 있습니다. 진행 상태가 보이지 않으면 중복 작업과 문의가 함께 늘어납니다.

실무 적용 방법

요청을 접수하면 작업 식별자를 반환하고 대기, 실행, 완료, 실패 상태를 조회할 수 있게 합니다. 진행률을 정확히 계산할 수 없다면 추정 숫자를 확정값처럼 표시하지 말고 현재 단계를 안내합니다. 취소 가능한 단계와 이미 반영된 결과의 처리 방식을 정합니다.

예외 상황과 확인 방법

실행 도중 취소 요청과 완료 처리가 겹치는 상황을 시험합니다. 취소 접수가 곧 취소 완료를 뜻하지 않도록 상태를 구분하고, 일부 반영된 데이터가 있다면 결과와 후속 조치를 사용자에게 보여줍니다.

적용 전 체크리스트

• 같은 작업을 다시 만들지 않고 상태를 확인할 수 있는가
• 취소 요청과 실제 취소 완료가 구분되는가
• 부분 반영과 실패 사유를 사용자에게 설명하는가

#API제한 #레이트리밋 #멀티테넌트 #SaaS운영 #공정성 #네이처프랙탈 #서비스품질 #제품개발 #운영설계 #디지털전환