시퀀스mono
비동기 작업과 폴링
클라이언트가 작업을 시작해 id를 받고, 워커가 끝낼 때까지 상태를 조회하는 시퀀스 다이어그램입니다.
이 템플릿으로 시작하기
에디터에서 열립니다. 가입 없이 SVG·PNG·임베드로 내보냅니다.
텍스트 코드
title: Async Job with Polling
theme: mono
type: sequence
participant client "Client"
participant api "API"
participant worker "Worker"
client -> api : "POST /jobs"
api --> client : "202 + job id"
api -> worker : "start job"
client -> api : "GET /jobs/id"
api --> client : "running"
worker --> api : "done"
client -> api : "GET /jobs/id"
api --> client : "done + result"템플릿 설명
폴링 방식 비동기 작업의 시퀀스 다이어그램입니다. 클라이언트가 작업을 시작하면 202 응답과 작업 id를 받습니다. API는 작업을 워커에 넘기고, 클라이언트는 상태가 "running"에서 결과와 함께 "done"이 될 때까지 GET /jobs/id를 반복 호출합니다.
내보내기, 영상 처리, AI 작업처럼 요청을 붙잡고 기다리면 타임아웃이 나는 장시간 API를 문서화할 때 씁니다.
폴링 대신 결과를 푸시하는 구조라면, 두 번째 GET을 API에서 클라이언트로 가는 웹훅이나 SSE 메시지로 바꾸면 됩니다.