개요

application/x-ndjson은 Newline-Delimited JSON, 즉 한 줄에 하나의 완결된 JSON 객체를 두고 줄바꿈(\n)으로 구분하는 형식의 미디어 타입입니다. 대량 레코드 스트리밍과 로그·데이터 파이프라인에 널리 쓰입니다(JSON Lines/JSONL과 동일 개념).

자세히

단일 거대한 JSON 배열과 달리, NDJSON은 각 줄이 독립된 문서라 전체를 메모리에 올리지 않고 한 줄씩 파싱·처리할 수 있습니다. 이 특성 덕분에 서버는 결과를 생성하는 대로 흘려보내고(청크 전송), 클라이언트는 도착하는 즉시 처리합니다. Elasticsearch의 _bulk API, 로그 수집기, 대용량 export가 대표 사용처입니다.

각 줄은 그 자체로 유효한 JSON이어야 하며 줄 내부에 실제 개행이 없어야 합니다(문자열 내 개행은 `\n`으로 이스케이프). 마지막 줄의 트레일링 개행 유무는 파서에 따라 다르니 관대하게 처리하세요. 실시간 서버→클라이언트 이벤트에는 브라우저 EventSource가 지원하는 text/event-stream(SSE)이 더 적합하고, NDJSON은 범용 데이터 스트리밍에 강합니다.

문법

e.g. Content-Type: application/x-ndjson

파일 확장자

실무 참고

• x- 접두사는 비표준(실험적) 등록을 뜻합니다. application/jsonlines, application/ndjson 등 변종 표기가 혼재하므로 소비 측과 합의하세요.
• 청크(Transfer-Encoding: chunked)로 흘릴 때 프록시·버퍼가 줄 경계에서 끊지 않도록 flush 처리를 확인하세요.
• 한 줄이라도 JSON 문법이 깨지면 그 레코드만 건너뛰도록 파서를 라인 단위로 견고하게 만드세요.

관련 타입

관련 헤더