달달툴즈

JSON 스키마 생성기

JSON 예시에서 JSON Schema 를 뽑아냅니다. 글의 모양을 알아보고 required 를 채우며 초안 판을 고를 수 있습니다.

브라우저에서만 처리무료 이용

예시에 있던 칸을 모두 넣습니다. 대개 나중에 손봐야 합니다.

date, date-time, email, uri, uuid, ipv4.

칸마다 예시로 쓴 값을 함께 적습니다.

파일은 서버로 전송되지 않고 브라우저에서만 처리됩니다.

사용 방법

가입도 설치도 없이, 사용 횟수 제한도 없이 무료로 쓸 수 있습니다.

응답 예시를 붙여 넣으면 스키마가 바로 나옵니다. 칸이 다섯 개면 손으로 적어도 되지만 쉰 개가 되면 못 할 일이고, 틀리는 자리도 늘 같습니다. 윗줄의 형을 그대로 베끼거나 칸 하나를 통째로 빠뜨립니다.

배열은 첫 항목만이 아니라 모든 항목을 봅니다. 목록 안의 어떤 객체에만 있는 칸도 스키마에 남고, 대신 required 에서는 빠집니다. 늘 있는 칸이 아니라는 것이 자료로 드러났기 때문입니다.

배열 안에 형이 섞이면 anyOf 로 둘 다 남겨 아무것도 조용히 사라지지 않게 합니다. 다만 정수와 실수는 예외로 number 하나로 접습니다. 두 가지로 갈라 두면 정확해지지도 않으면서 읽기만 어려워집니다.

글의 모양은 확실한 것만 알아봅니다. 날짜·시각·메일·주소·UUID·IPv4 의 또렷한 꼴만 잡습니다. 여기서 잘못 짚으면 스키마가 실제 자료를 거절하게 되는데, 그 원인을 찾는 일이 format 을 손으로 적는 것보다 오래 걸립니다.

나오는 것은 예시 하나의 모양입니다. 선택적인 칸이나 값의 범위, 정해진 목록 같은 것은 예시 한 개에 드러나지 않으므로, 완성된 명세가 아니라 고쳐 쓸 초안으로 보세요.

아무것도 올라가지 않습니다. API 응답에는 실제 고객 자료가 들어 있기 마련이고, 그것만으로도 브라우저 안에 둘 이유가 됩니다.

이런 도구도 함께 씁니다