OpenAPI 3.2

HTTP QUERY·추가 연산·스트리밍 표현 같은 API 계약을 명세에 적을 수 있습니다.

···
html
<div class="viz"><h3>OPENAPI 3.2 → DOCS</h3><div class="row"><div class="box code" id="spec">query: /search</div><span class="arrow">→</span><div class="box" id="docs">QUERY /search<br>body + results</div></div><div class="muted" id="hint">operation described in spec</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}#spec,#docs{min-width:38%}#docs{border-color:var(--accent)}
js
let stream=false;function draw(){stream=!stream;document.getElementById('spec').textContent=stream?'text/event-stream':'query: /search';document.getElementById('docs').innerHTML=stream?'GET /events<br>stream of items':'QUERY /search<br>body + results';document.getElementById('hint').textContent=stream?'stream media described in spec':'operation described in spec'}draw();setInterval(draw,1700)

OpenAPI 3.2는 HTTP API를 기술하는 명세의 2025년 판입니다. 경로와 연산, 요청·응답, 스키마를 기계가 읽을 수 있는 형식으로 적습니다. 이 판에는 QUERY 메서드, 추가 HTTP 연산, 순차·스트리밍 미디어 표현 등을 기술하는 방법이 들어갔습니다.

데모는 명세의 연산·응답 유형을 바꾸면 생성되는 문서 카드가 바뀌는 모습을 보여줍니다. 명세가 실행 코드를 자동으로 올바르게 만들어 주는 것은 아니므로 실제 구현과 계약이 일치하는지 검증해야 합니다.

언제 쓰나

새 HTTP 연산이나 스트리밍 응답까지 API 문서·도구 계약에 담아야 할 때 사용합니다.

페이지로 열기 ↗