Cộng đồng Hỏi & Đáp của Inflearn

안녕하세요! 카카오개발자 센터의 공식 문서에서는 토큰 발급 api 요청 시 content-type을 "application/x-www-form-urlencoded;charset=utf-8" 로 데이터를 전달하라고 되어있습니다.

말씀해주신 @RequestBody, @ModelAttribute 등 으로 호출해보시면 아시겠지만 카카오 서버에서 처리할 수 없어서 오류가 발생할 것입니다.

content-type을 "application/x-www-form-urlencoded;charset=utf-8" 로 전달한다는 것을 http 메세지를 아래의 예시처럼 보낸다는 것 입니다.

body 본문을 보시면 쿼리파라미터처럼 key1=value1&key2=value2 처럼 데이터를 보내고 있는데 이 방식이 바로 "application/x-www-form-urlencoded;charset=utf-8" 로 보내는 방식입니다.

POST /oauth/token HTTP/1.1

Host: https://kauth.kakao.com

Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code&client_id=123456&redirect_uri=http://localhost:8080/oauth/kakao/callback&client_secret=1234&code=123452

따라서 카카오 API 서버에서 지원하지 않는 http 메세지 형식으로 보낸다면 해당 서버에서 처리를 하지 못하기 때문에 오류가 발생할 수도 입니다.

그리고 예시로 주셨던 코드의 경우 consumes에 APPLICATION_FORM_URLENCODED_VALUE 를 지정해주셨는데 consume의 경우 우리 서버가 받을 contenty-type을 명시합니다.

APPLICATION_FORM_URLENCODED_VALUE은 저희가 카카오로 보낼 데이터 타입이구요!

@PostMapping(value = "/oauth/token", consumes = APPLICATION_FORM_URLENCODED_VALUE)

KakaoTokenResponse requestKakaoToken(@RequestBody KakaoTokenRequest request);

아래처럼 카카오 서버로 부터 받는 응답을 application/json으로 수정 후 요청 한다고 했을 때 @RequestBody의 경우 request의 데이터를 http body에 json으로 전달합니다.

@PostMapping(value = "/oauth/token", consumes = "application/json")

KakaoTokenResponse requestKakaoToken(@RequestHeader("Content-Type") String contentType, @RequestBody KakaoTokenRequest request);

http 메세지는 아래 예시처럼 전송이 될 것입니다. 이번에는 http body의 데이터 형식이 key1=value1 형식이 아니라 json으로 전송이 될 것이고 카카오 서버에서는 "application/x-www-form-urlencoded" 형태로 데이터를 보내라고 했는데 저희가 마음대로 데이터를 json 형식으로 보내게 된것이구요! 그래서 해당 서버가 메세지를 정상적으로 읽을 수 없어서 오류가 발생할 것 입니다.

POST /oauth/token HTTP/1.1

Host: https://kauth.kakao.com

Content-Type: application/json

{

"grant_type": "authorization_code",

"client_id": "123123123123",

"redirect_uri": "http://localhost:8080/oauth/kakao/callback",

"code": "123123123123123",

"client_secret": "3124123123123"

}

@ModelAttribute와 아무 어노테이션도 사용하지 않고 보냈을 때는 둘다 json 형태로 데이터를 전달하는 것으로 로그를 확인했고 application/json은 카카오 토큰 발급 api에서 처리할 수 없어서 오류가 발생했습니다.

@PostMapping(value = "/oauth/token", consumes = "application/json")

KakaoTokenResponse requestKakaoToken(@ModelAttribute KakaoTokenRequest request);

@PostMapping(value = "/oauth/token", consumes = "application/json")

KakaoTokenResponse requestKakaoToken(KakaoTokenRequest request);

안녕하세요, 인프런 AI 인턴입니다. shsf님.

카카오 토큰 발급과 관련된 문의에 대해 답변 드리겠습니다. 토큰 발급에 있어 POST 요청과 application/x-www-form-urlencoded를 사용해야 하는 경우가 흔히 있는데, 이에 대해 여러 가지 옵션이 있어 혼란스러우실 수 있습니다.

1. 쿼리 파라미터 vs 메시지 바디:

   • 카카오는 메시지 바디에 쿼리 파라미터 형식으로 데이터를 전달하는 것을 권장하며, 이 방식으로 요청을 처리합니다. URL 쿼리 파라미터에 포함하는 것보다 POST 의 본문에 application/x-www-form-urlencoded 타입으로 전달하는 것이 일반적입니다.
     
   • @SpringQueryMap은 feign 클라이언트 라이브러리를 사용할 때 쿼리 파라미터를 자동으로 매핑하는 역활을 하며, 실제로는 카카오와 같은 API 요청에서는 잘 사용되지 않습니다. API에서는 바디를 통해 전달하는 것이 맞습니다.
     

2. PostMapping 방식 선택:

   • @PostMapping(value = "/oauth/token", consumes = APPLICATION_FORM_URLENCODED_VALUE)의 경우 메시지 바디로 데이터를 전달할 때는 일반적으로 @ModelAttribute를 사용합니다.
     
   • @ModelAttribute는 데이터가 폼 데이터이거나 쿼리 스트링이 필요할 때 주로 사용되며, application/x-www-form-urlencoded로 요청하는 경우 이 선택이 맞습니다.
     
   • @RequestBody는 JSON 형식의 데이터를 파싱해주는 역할로, 폼의 경우에는 적절하지 않을 수 있습니다.
     
   • requestKakaoToken(KakaoTokenRequest request)는 @ModelAttribute를 생략한 단순한 방식으로 처리될 수 있으며, Spring은 자동으로 폼 데이터를 바인딩해줍니다.
     

다양한 방식들이 있으나, 일반적인 적용 순서 및 방법은 다음과 같습니다. @ModelAttribute를 사용하는 것이 카카오의 application/x-www-form-urlencoded 요청 방식에 가장 부합합니다.

아무쪼록 올바른 방향으로 프로젝트를 진행하시는데에 도움이 되기를 바라며, Feign 클라이언트와 Content-Type 관련 문의 페이지를 통해 더욱 깊이 이해하실 수 있습니다.

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.