Unsupported Media Type

개요

415 Unsupported Media Type는 요청 본문의 형식(Content-Type)을 서버가 지원하지 않아 거부했다는 뜻입니다. 예를 들어 JSON만 받는 엔드포인트에 XML이나 text/plain을 보내면 발생합니다.

406 Not Acceptable이 '응답(서버가 만드는 것)' 협상 실패라면, 415는 '요청 본문(클라이언트가 보내는 것)'의 형식이 맞지 않는 경우라는 점이 다릅니다.

언제 발생하나

• JSON API에 XML이나 form-data를 보냈을 때
• Content-Type 헤더가 없거나 실제 본문과 다를 때
• 서버가 지원하지 않는 Content-Encoding(예: 낯선 압축)을 사용했을 때

요청 / 응답 예시

POST /api/users HTTP/1.1
Host: api.example.com
Content-Type: text/xml

<user><name>Kim</name></user>

HTTP/1.1 415 Unsupported Media Type
Accept-Post: application/json
Content-Type: application/json

{"error":"unsupported_media_type","expected":"application/json"}

코드로 보기

app.post('/api/users', (req, res) => {
  if (!req.is('application/json')) {
    return res.status(415)
      .set('Accept-Post', 'application/json')
      .json({ error: 'unsupported_media_type' });
  }
  // ...
});

curl -X POST https://api.example.com/api/users \
  -H 'Content-Type: application/json' \
  -d '{"name":"Kim"}'

실무 참고

• 브라우저 fetch로 JSON을 보낼 때 Content-Type: application/json을 빠뜨리는 실수가 흔합니다. 헤더를 명시했는지 먼저 확인하세요.
• charset이나 boundary 같은 파라미터가 잘못돼도 415가 날 수 있으니 Content-Type 값 전체를 점검하세요.

관련 상태코드

관련 헤더

스펙 근거