Arazzo API 워크플로

Arazzo API Workflows

여러 API 호출을 단계와 입출력 연결로 묶어 하나의 사용자 흐름으로 기술합니다.

···
html
<div class="viz"><h3>WORKFLOW OUTPUTS</h3><div class="row"><div class="box step" id="a">auth<br><small>token</small></div><span class="arrow">→</span><div class="box step" id="b">create<br><small>orderId</small></div><span class="arrow">→</span><div class="box step" id="c">retrieve</div></div><div class="muted" id="carry">token → create</div></div>
css
.viz{width:94%;height:88%;max-width:960px;padding:clamp(10px,2vmin,18px);border:1px solid var(--line);border-radius:14px;background:var(--surface);font:600 clamp(12px,1.35vw,16px)/1.35 var(--font-sans,system-ui,sans-serif);display:flex;flex-direction:column;gap:clamp(7px,1.8vmin,13px);overflow:hidden}.viz h3{margin:0;color:var(--accent);font:700 clamp(12px,1.35vw,16px)/1.2 var(--font-sans,system-ui,sans-serif);letter-spacing:.04em}.viz .row{display:flex;align-items:center;justify-content:center;gap:clamp(5px,1.4vmin,12px);flex:1;min-height:0}.viz .box{padding:clamp(5px,1.5vmin,12px);border:1px solid var(--line);border-radius:9px;background:var(--bg);text-align:center}.viz .muted{color:var(--muted)}.viz .accent{color:var(--accent)}.viz .code{font-family:ui-monospace,monospace}.viz .pill{padding:3px 7px;border:1px solid var(--line);border-radius:99px;white-space:nowrap}.viz .active{border-color:var(--accent);background:color-mix(in srgb,var(--accent) 12%,var(--surface))}.viz .arrow{color:var(--accent);font:700 18px ui-monospace,monospace}.step{min-width:22%;transition:background .3s,border-color .3s}.step.on{border-color:var(--accent);background:color-mix(in srgb,var(--accent) 16%,var(--surface))}.step small{font:12px ui-monospace,monospace;color:var(--muted)}
js
let n=0;function draw(){['a','b','c'].forEach((id,i)=>document.getElementById(id).classList.toggle('on',i===n));document.getElementById('carry').textContent=['token → create','orderId → retrieve','result ready'][n];n=(n+1)%3}draw();setInterval(draw,900)

Arazzo는 OpenAPI Initiative의 다단계 API 워크플로 명세입니다. 개별 엔드포인트의 모양을 넘어서 어떤 단계를 어떤 순서로 호출하고 앞 단계의 결과를 다음 단계 입력에 어떻게 전달하는지 적습니다. 여러 API 설명을 참조할 수 있습니다.

데모는 인증 토큰과 생성된 주문 ID가 다음 단계로 넘어가는 장면을 재생합니다. 워크플로 문서는 실제 인증·상태 관리와 함께 시험해야 하며, 단계의 실패 조건과 재시도 정책도 고려해야 합니다.

언제 쓰나

인증→생성→조회처럼 여러 호출이 이어지는 사용 시나리오를 계약으로 공유할 때 사용합니다.

페이지로 열기 ↗