Format Atlas

가이드

웹 데이터와 설정 형식 선택

API 같은 시스템 간 교환에는 JSON, 사람이 편집하는 설정에는 YAML, 기존 스키마 기반 연동에는 XML을 고려하세요.

어떤 형식을 선택해야 할까요?

작업 흐름에서 파일이 맡는 역할에 따라 선택하세요.

  • 웹 API → JSON
  • 사람이 편집하는 설정 → YAML
  • 기존 스키마나 계약 → XML

수신자가 요구하는 형식을 사용

세 형식 모두 구조화 데이터를 표현하지만 문법, 주석, 형식 해석, 스키마 작업이 다릅니다. 먼저 계약과 도구를 확인하세요.

고려할 형식

JSON

적합한 용도: API와 JSON 기반 교환

적합하지 않은 용도: 주석이 필요한 수동 설정

YAML

적합한 용도: 사람이 유지하는 설정

적합하지 않은 용도: JSON만 허용하는 API

XML

적합한 용도: 기존 XML 스키마와 연동

적합하지 않은 용도: XML 요구가 없는 새 간단한 API

내보내기 전 확인

  • YAML을 JSON의 엄격한 상위 집합으로 가정하지 마세요.
  • 인코딩, 형식, 스키마 처리를 수신자와 확인하세요.

관련 비교

가이드

참고 자료 및 사양