Partial Content

개요

206 Partial Content는 클라이언트가 Range 헤더로 요청한 리소스의 일부(바이트 구간)만 서버가 전달했음을 나타냅니다. 응답의 Content-Range 헤더가 어떤 구간을 전체 크기 중 어디까지 보냈는지 알려 줍니다.

이 코드는 이어받기(끊긴 다운로드 재개)와 미디어 스트리밍의 핵심으로, 큰 파일을 통째로 다시 받지 않고 필요한 부분만 가져오게 해 줍니다.

언제 발생하나

• 동영상 플레이어가 사용자가 이동한 재생 위치의 바이트 구간만 요청할 때, 서버가 해당 조각을 206으로 반환합니다.
• 다운로드 관리자나 curl -C -가 중단된 파일의 나머지 바이트만 이어받을 때 발생합니다.

요청 / 응답 예시

GET /video.mp4 HTTP/1.1
Host: media.example.com
Range: bytes=1048576-2097151

HTTP/1.1 206 Partial Content
Content-Range: bytes 1048576-2097151/5242880
Content-Length: 1048576
Content-Type: video/mp4
Accept-Ranges: bytes

(binary chunk)

코드로 보기

# request bytes 500-999 of a file
curl -H 'Range: bytes=500-999' https://media.example.com/video.mp4 -o part
# or resume a broken download
curl -C - -O https://media.example.com/video.mp4

const res = await fetch('/video.mp4', {
  headers: { Range: 'bytes=0-1023' }
});
console.log(res.status);            // 206
console.log(res.headers.get('Content-Range'));

실무 참고

• 서버가 범위 요청을 지원하려면 Accept-Ranges: bytes를 광고하고, 응답에 정확한 Content-Range를 담아야 합니다.
• 요청한 범위가 파일 크기를 벗어나면 206이 아니라 416 Range Not Satisfiable이 반환됩니다.
• 여러 구간을 한 번에 요청하면 multipart/byteranges 형식으로 여러 조각이 하나의 206 본문에 담깁니다.

관련 상태코드

관련 헤더

스펙 근거