OpenAPI·GraphQL·Postman 도구
API 계약 작업은 YAML을 쓰는 것 이상입니다. 스키마 변경이 클라이언트를 망가뜨리는지 확인하거나, Postman 컬렉션을 버전 관리할 스펙으로 바꾸거나, 백엔드가 나오기 전에 목 데이터를 만들어야 할 때가 있습니다. OpenAPI와 GraphQL 편집·비교·목킹, Postman 변환, curl 생성을 다룹니다.
OpenAPI 스펙 비교나 GraphQL 스키마 비교는 삭제된 필드, 바뀐 타입, 좁아진 인자 같은 파괴적 변경을 릴리스 전에 찾아줍니다. OpenAPI Mock 데이터 생성은 operation에서 요청·응답 JSON을 만들어 프런트엔드가 실제 API 없이 작업을 시작하게 합니다. 모든 처리는 브라우저에서 이루어집니다.
도구 7개
OpenAPI / GraphQL / Postman 도구 전체 보기
-
Postman OpenAPI 변환
Postman 컬렉션과 OpenAPI를 변환하기
-
OpenAPI 검증기
OpenAPI 스펙의 구조와 필드를 검증하기
-
OpenAPI 스펙 비교
두 OpenAPI 버전의 변경 사항을 비교하기
-
OpenAPI Mock 데이터 생성
OpenAPI로 Mock 테스트 데이터를 생성하기
-
GraphQL 작업 도구
GraphQL 쿼리와 SDL을 정리하고 스키마로 검사하기
-
GraphQL 스키마 비교
GraphQL 스키마의 변경 사항을 추적하기
-
cURL 변환기
cURL 명령을 Fetch·Axios·Python 코드로 변환하기
OpenAPI / GraphQL / Postman 도구 FAQ
두 스펙 버전을 OpenAPI 스펙 비교에 넣어 경로, 매개변수, 스키마의 추가·삭제·변경을 나란히 확인하세요. 삭제된 필드, 새로 필수가 된 매개변수, 좁아진 타입이 예전 스펙으로 동작하던 클라이언트를 망가뜨릴 가능성이 가장 큽니다.
네, Postman OpenAPI 변환은 Postman 컬렉션 내보내기 파일을 읽어 확인 가능한 요청을 포함한 OpenAPI 문서로 다시 만들어줍니다. 완전 자동에 손실 없는 변환이라기보다는 OpenAPI 검증기에서 다듬어 나갈 출발점으로 보면 됩니다.
REST 비교는 OpenAPI 문서 전체의 경로, 메서드, 매개변수, JSON 스키마를 비교합니다. GraphQL 스키마는 하나의 타입 그래프라서 GraphQL 스키마 비교는 대신 타입, 필드, 인자를 직접 비교하는데, 이것이 기존 쿼리가 계속 해석되는지를 실제로 결정합니다.