JSON → OpenAPI 스키마 생성
JSON을 붙여넣으면 OpenAPI 컴포넌트 스키마를 바로 만듭니다.
객체와 배열을 JSON Schema로 변환해 필수 필드를 포함하고, 혼합 배열은 oneOf로 표현합니다.
모든 처리는 브라우저에서만 이뤄지며, 데이터가 서버로 전송되지 않습니다.
JSON에서 OpenAPI 스키마 생성
샘플 JSON을 OpenAPI schema로 변환해 request, response, components.schemas 문서화의 초안을 만들 수 있습니다. 각 property를 수동으로 작성하는 시간을 줄여줍니다.
도움이 되는 상황
- endpoint 문서화: 실제 응답에서 schema를 시작합니다.
- API 계약 정리: 타입, required property, 중첩 구조를 확인합니다.
- Swagger 문서 준비: OpenAPI용 schema 초안을 생성합니다.
format, enum, optional field, array 제약은 자동 추론만으로 충분하지 않을 수 있으니 직접 검토하세요.
이 도구의 관련 기사
JSON을 OpenAPI 스키마로 변환하기｜Swagger 대응 무료 변환기
JSON이 OpenAPI 3.1의 components 스키마로 변환되는 원리를 해설합니다. 타입 추론 규칙, 배열 내 타입 혼재를 oneOf로 표현하는 방법, 날짜 문자열 자동 감지, 생성 후 확인해야 할 점까지 다룹니다.
JSON 포맷팅과 검증: API 응답을 안전하게 확인하는 방법
JSON을 보기 좋게 정리하고, 문법 오류와 값의 타입을 확인하며, TypeScript 타입과 Zod, OpenAPI 스키마로 이어지는 실무 흐름을 설명합니다.
JSON 에코시스템 입문: 포맷팅·타입 생성·검증·API 정의를 예제로 잇기
JSON을 기점으로 TypeScript 타입, Zod 런타임 검증, OpenAPI 정의로 전개하는 일련의 흐름을 실제 코드로 이어 해설. 타입 안전한 API 개발의 전체 그림을 알 수 있습니다.
JSON Schema와 Zod를 상호 변환하는 원리｜required와 .optional()의 대응
JSON Schema에서 Zod 스키마를 만들고 Zod 코드에서 다시 JSON Schema를 뽑아내는 양방향 변환기의 구현을 해설합니다. required와 .optional()의 기본값이 반대인 문제, 제약 조건 대응표, 코드를 실행하지 않고 해석하는 방법까지 정리합니다.
최신 아티클
curl 옵션 정리｜-X -H -d 가 실제로 하는 일과 함정
실무에서 만나는 curl 옵션을 표로 정리했습니다. -d 만으로 이미 POST가 되는 이유, -d 와 --data-raw 의 차이, 앞의 @ 가 조용히 파일을 읽는 함정, 작은따옴표와 큰따옴표의 구분, -k 와 -L 을 쉽게 붙이면 안 되는 이유까지 예제로 설명합니다.
JSON Schema와 Zod를 상호 변환하는 원리｜required와 .optional()의 대응
JSON Schema에서 Zod 스키마를 만들고 Zod 코드에서 다시 JSON Schema를 뽑아내는 양방향 변환기의 구현을 해설합니다. required와 .optional()의 기본값이 반대인 문제, 제약 조건 대응표, 코드를 실행하지 않고 해석하는 방법까지 정리합니다.
SQL 절 실행 순서 레퍼런스｜WHERE에서 SELECT 별칭을 못 쓰는 이유
SQL은 작성한 순서대로 실행되지 않습니다. 논리적 실행 순서(FROM → WHERE → GROUP BY → HAVING → SELECT → ORDER BY → LIMIT)를 축으로, 별칭이 WHERE에서 안 되는 이유, WHERE와 HAVING의 구분, ONLY_FULL_GROUP_BY, COUNT(*)와 COUNT(컬럼)의 차이, LEFT JOIN + WHERE 함정을 예제로 정리합니다.
unified diff 형식 읽는 법｜git diff의 @@ 헤더 완전 해설
git이 출력하는 unified diff 형식을 읽는 법을 정리했습니다. @@ -12,7 +12,9 @@ 의 네 숫자가 뜻하는 것, 한 글자만 고쳐도 줄 전체가 바뀐 것처럼 보이는 이유, 공백과 줄바꿈 문자의 함정, \ No newline at end of file, 머지 커밋의 @@@, similarity index를 통한 이름 변경 감지까지 예제로 설명합니다.
UTC⇄JST/KST 변환 레퍼런스｜9시간 시차 대조표와 타임존 사고 예방법
UTC와 일본 시간(JST)·한국 시간(KST)의 변환을 대조표로 정리했습니다. ISO 8601의 Z와 +09:00의 의미, JavaScript 날짜 파싱이 9시간 어긋나는 조건, MySQL/PostgreSQL의 타임존 동작, GitHub Actions cron이 UTC로 도는 함정까지 예제와 함께 해설합니다.
CREATE TABLE 레퍼런스｜MySQL·PostgreSQL·SQLite의 타입과 제약 조건 차이
CREATE TABLE(DDL) 작성법을 3개 데이터베이스 비교표로 정리했습니다. 타입 대응표, 자동 증가(AUTO_INCREMENT / IDENTITY / rowid)의 방언 차이, 외래 키의 ON DELETE 동작, MySQL이 조용히 무시하는 CHECK 제약까지 예제와 함께 해설합니다.