API 눌러 보기
연산 목록 · 예시 요청 만들기 · 예시 답 만들기 · 목 서버에 붙일 표
API 눌러 보기
OpenAPI 스펙을 붙여넣으면 연산 목록이 서고, 값을 채워 그 자리에서 보내 봅니다. 목 응답도 만들어 줍니다
보낼 요청
답
OpenAPI 문서를 붙여넣으세요
두 판의 OpenAPI 문서를 붙여넣으세요
OpenAPI 문서를 읽어 어떤 요청을 보낼 수 있는지 표로 보여 주고, 스키마에서 보낼 몸통·받을 답의 예시를 만들어 줍니다.
이렇게도 부른다 — swagger · 테스트 · mock · 목서버 · test · spec
쓰는 법
- OpenAPI 문서(JSON 또는 YAML) 붙여넣기
- 나온 연산 목록에서 하나 고르기
- 경로·질의 값 채우면 진짜 보낼 수 있는 주소가 만들어짐
- 예시 답을 받아 자기 목 서버(msw·json-server)에 붙이기
다른 곳과 뭐가 다른가
- 경로에 공통으로 걸린 파라미터를 각 연산이 물려받습니다 — 필수 값이 사라지지 않습니다.
- example 이 적혀 있으면 그대로 쓰고, 없으면 형식(date-time·uuid·email)에 맞는 값을 지어냅니다.
자주 묻는 질문
- 가짜 서버도 세워 주나요?
- 안 세웁니다. 브라우저에서 가짜 서버를 세우려면 Service Worker 를 등록해야 하는데 이 사이트에는 이미 자기 것이 있어서, 도구 하나 때문에 사이트 전체 요청을 가로챌 위험을 지지 않습니다. 대신 목 서버에 그대로 붙일 「경로 → 답」 표를 만들어 줍니다.
- $ref 로 나뉜 문서도 읽나요?
- 문서 안의 $ref(#/components/…)는 따라갑니다. 스스로를 가리키는 고리는 거기서 멈추고 빈 값으로 둡니다.
- 문서가 서버로 가나요?
- 안 갑니다. 읽고 만드는 것 전부 브라우저 안에서 끝납니다.
다른 도구
당신이 정한 주소로 감 당신이 적은 주소로 요청이 실제로 나갑니다 — 그 주소의 주인에게 내용이 전달됩니다.
적은 주소·헤더·본문 그대로 브라우저가 요청을 보냅니다. 우리 서버를 거치지 않습니다.
가는 곳 — 당신이 적은 주소