415 Unsupported Media Type은 콘텐츠의 형식을 해당 메서드와 리소스가 지원하지 않아 원본 서버가 요청을 거부한다는 뜻입니다. 문제는 Content-Type(예: JSON 전용 엔드포인트에 보낸 XML), Content-Encoding(예: gzip으로 압축한 요청 본문), 또는 데이터 자체에 있을 수 있습니다.
서버는 응답에 Accept 헤더를 보내 허용하는 미디어 유형을 알려 주거나, 지원하지 않는 콘텐츠 코딩이 문제라면 Accept-Encoding을 보내 클라이언트를 도울 수 있습니다.
클라이언트가 요청한 응답 형식에 관한 406과 혼동하지 마세요.
응답 예시
HTTP
HTTP/1.1 415 Unsupported Media Type
Date: Fri, 06 Nov 2026 10:15:32 GMT
Accept: application/json
Content-Type: application/json
Content-Length: 49
{"error":"Content-Type must be application/json"}SEO 및 리디렉션 검사
크롤러는 요청 본문을 보내지 않으므로 415는 SEO에 영향이 없습니다. 메서드를 POST로 설정한 리디렉션 검사에서 415가 나온다면 대상 서버가 다른 Content-Type을 기대한다는 뜻입니다. 사용자 지정 요청 헤더에 Content-Type: application/json처럼 추가하세요.
주요 원인과 사용 사례
- JSON API가
Content-Type: application/json없이 본문을 받았습니다. - 폼이 JSON만 받는 엔드포인트에
multipart/form-data를 보내거나, 그 반대의 경우입니다. - 요청 본문이 서버가 지원하지 않는 인코딩으로 압축되었습니다.