개요

application/graphql은 GraphQL 쿼리 문서를 본문으로 전송할 때 쓰이는(비공식·부분 표준화된) 미디어 타입입니다. GraphQL API는 보통 단일 엔드포인트에 POST로 쿼리를 보내고 JSON으로 결과를 받습니다.

자세히

실무의 두 가지 방식이 있습니다. ① application/json 본문에 `{"query":"...","variables":{...}}` 형태로 쿼리를 담는 방식(가장 널리 쓰임). ② application/graphql로 본문 전체를 원시 쿼리 문자열로 보내는 방식(변수 전달이 없어 제한적). 대다수 서버(Apollo·GraphQL-Yoga)는 ①을 기본으로 지원하고 ②를 선택적으로 받습니다.

최근 GraphQL over HTTP 명세는 응답에 대해 `application/graphql-response+json`이라는 새 타입을 정의해, 프로토콜 수준 오류와 실행 오류를 상태코드로 구분하려 합니다. 응답은 항상 data와 errors를 담는 JSON이며, GraphQL은 부분 성공을 표현할 수 있어 200 응답에도 errors가 존재할 수 있습니다.

문법

e.g. Content-Type: application/graphql

파일 확장자

실무 참고

• application/graphql 본문은 변수를 실을 수 없어, 변수가 필요하면 application/json + query/variables 구조를 쓰세요.
• GraphQL은 HTTP 상태코드보다 응답 본문의 errors 배열로 오류를 표현하는 경향이 있어, 클라이언트는 200이어도 errors를 반드시 확인해야 합니다.
• 단일 엔드포인트 특성상 쿼리 깊이·복잡도 제한이 없으면 DoS에 취약합니다 — depth/complexity 제한을 두세요.

관련 타입

관련 헤더