Postman : GraphQL query 요청하기

신규로 개발되는 applcation이 GraphQL query를 통해 연동 API 설계가 되었다.

검증을 위해 GraphQL query 요청은 어떤 도구로 사용을 해야할까 검색을 해봤더니 이미 많이 활용하고 있던 Postman에서 GraphQL query 요청을 지원하고 있었다.

가이드를 따로 보지 않고 개발된 Application의 API spec 문서만 보고 요청을 간단히 시도해 보았는데, 최초 요청이 실패하였다. 원인은 header에 Content-Type이 문제였다; 기존에 자주 사용하던 json 형태로 셋팅이 되어 있었고, 이 부분을 graphql 로 변경하고 성공하였다.

 

아래 요청 시, 변경 또는 신경써줘야할 부분에 대해 붉은색으로 표시하였다.

** Postman 공식 Link : https://learning.postman.com/docs/sending-requests/supported-api-frameworks/graphql/#using-postmans-built-in-support-for-graphql

 

 

기본 셋팅이 되어 있던 Content-Type을 체크 해제한 후, Content-Type을 추가하고 "application/graphql" 로 입력

 

GraphQL 을 선택하게되면 query format이 자동으로 셋팅되는데, 개발된 application에서 파싱이 실패되어 "raw" 타입으로 선택한 후 query를 raw text로 넣어 요청하였다.

 

결과는 성공.

큰 팁은 아니었지만, 잠시 삽질을 하게 되었던 부분이라 기록으로 남겨둔다.