JSON 입력

생성된 스키마

JSON 스키마 생성기란?

API의 데이터 구조를 문서화해야 하는데 JSON Schema를 직접 작성하기 싫었던 적 있으신가요? 바로 이 도구가 그 해결책입니다. JSON(JavaScript Object Notation) 데이터를 붙여넣으면 구조, 타입, 유효성 검사 규칙을 설명하는 완전한 스키마를 자동으로 생성합니다.

API 문서화, 데이터 유효성 검사, 또는 JSON에 실제로 무엇이 담겨 있는지 파악하는 데 완벽합니다. MDN Web Docs가 설명하듯 JSON Schema는 데이터 구조 검증에 도움을 주며, 저희 생성기는 공식 JSON Schema 사양을 따릅니다. 중첩 객체, 배열, 까다로운 부분을 모두 자동으로 처리합니다.

가장 좋은 점은 모든 것이 브라우저 내에서 처리된다는 것입니다. 데이터가 컴퓨터를 떠나지 않습니다. 업로드 없이, 기다림 없이, 즉시 스키마가 생성됩니다.

JSON 스키마 생성기 사용 방법

JSON 데이터에서 JSON Schema를 생성하는 단계입니다. 각 단계는 이 페이지의 실제 버튼과 패널을 사용합니다.

JSON 붙여넣기 또는 파일 업로드

왼쪽 JSON 입력 패널에 JSON을 붙여넣거나 업로드를 클릭하여 .json 또는 .txt 파일을 불러오세요. 샘플을 클릭하면 예시 데이터를 볼 수 있습니다. 입력 예시:

{"subscriberId": "SUB-1001", "plan": "Unlimited 5G", "dataUsage": 45.2, "status": "active"}

객체와 배열 모두 지원합니다. 잘못된 JSON은 오류가 표시됩니다.

생성된 스키마 확인

오른쪽 생성된 스키마 패널에 스키마가 자동으로 표시됩니다. 타입(string, number, boolean, object, array)을 감지하고 중첩 구조를 처리하며 필수 필드와 선택 필드를 식별합니다. JSON Schema 사양을 따릅니다. 두 패널 모두 구문 강조가 적용됩니다.

복사 또는 다운로드

복사를 클릭하여 스키마를 클립보드에 복사하거나 다운로드로 파일을 저장하세요. Swagger/OpenAPI 문서나 유효성 검사 라이브러리에서 스키마를 사용하세요. 입력 패널에서 지우기를 클릭하면 처음부터 시작할 수 있습니다. 모든 처리가 브라우저에서 실행됩니다.

실제로 이 도구를 사용하는 경우

API 문서화

API 응답 예시가 있나요? 거기서 스키마를 생성하여 Swagger/OpenAPI 문서에 사용하세요. 직접 스키마를 작성하는 것보다 훨씬 빠릅니다.

데이터 유효성 검사

수신 JSON을 검증해야 하나요? 스키마를 생성하고 유효성 검사 라이브러리와 함께 사용하여 데이터가 예상과 일치하는지 확인하세요.

타입 정의

데이터 구조를 파악하기 위해 스키마를 생성합니다. 복잡한 JSON 형식을 문서화하거나 API 계약을 이해하는 데 완벽합니다.

계약 테스트

계약 테스트를 위한 스키마를 만드세요. 스키마 유효성 검사를 사용하여 API 응답이 예상 구조와 일치하는지 확인합니다.

자주 묻는 질문

JSON 데이터가 저장되나요?

아닙니다. 모든 처리가 브라우저 내에서 이루어집니다. JSON이 컴퓨터를 떠나지 않으며 저희도 볼 수 없습니다.

어떤 버전의 JSON Schema가 사용되나요?

JSON Schema Draft 7 이상과 호환되는 스키마를 생성합니다. 공식 사양을 따르므로 표준 유효성 검사 도구에서 작동합니다.

배열도 처리할 수 있나요?

물론입니다. 배열은 문제없이 처리됩니다. 객체 배열이 있으면 객체 구조를 분석하여 적절한 항목 스키마를 만들어드립니다.

선택 필드와 필수 필드는 어떻게 구분하나요?

JSON 샘플을 분석하여 매번 등장하는 필드를 파악합니다. 그것들이 필수로 표시되고, 때때로 나타나는 필드는 선택으로 표시됩니다.

생성된 스키마를 편집할 수 있나요?

물론입니다. 출력 패널을 완전히 편집할 수 있어 타입을 변경하고, 제약 조건을 추가하거나, 필요에 맞게 조정할 수 있습니다.

잘못된 JSON으로도 작동하나요?

작동하지 않습니다. 먼저 유효한 JSON이 필요합니다. 문제가 있으면 오류가 표시됩니다. 먼저 JSON 유효성 검사기 또는 JSON 수정 도구를 사용해보세요.

다른 JSON 도구도 필요하신가요?

스키마 생성은 필요한 기능 중 하나일 뿐입니다. 함께 사용하면 좋은 다른 도구들입니다: