Monday API - 사용 셋팅

최근 사내에서  Monday API 사용 방법에 대해 가이드 해 줄 수 있는지 문의가 들어왔다. 

당시엔 내가 뭘 안다고 싶어서 가이드는 거절하고 문의하면 답변 해주기로만 이야기 했었다.

공식 가이드가 존재하는데 아는 척 하는게 부끄럽고 가이드가 잘 되어 있어 내가 뭔가 더 알려줄 수 있을 건이 없어 보였기 때문이다. 

 

헌데 시간이 지나고 생각해보니 GraphQL을 처음 보고 당황했던 과거의 내 기억이 떠 올랐다. 

해서, 가이드라긴 부끄럽고 그냥 차근 차근 내가 밟았던 Step 들만 정리해서 가지고 있다가 나중에 문의가 오면 답변해주려 한다. (혹은 요청자 분이 이 글을 보게 될 지도 모르고) 

 

2020년 초 사내에서 Monday를 도입하게 되었고 이때, Monday API를 보고 GraphQL 에 대해 처음 알게 되었다. 

기존 REST API와는 다르게 단 하나의 endpoint를 Structed Query Language로 쿼리를 조합하여 호출하는 이 방식은 (약간 극단적으로 말하면) 내가 쿼리 하는데로 데이터를 추출할 수 있는 API 호출 방식이다. 

 

가장 이해가 잘되었던 그림

상단 이미지의 출처(내 경우): https://tech.kakao.com/2019/08/01/graphql-basic/

1. 호출을 원하는 사용자 계정 셋팅 

API 로 호출 가능한 보드의 범위가 사용자의 계정 범위로 국한되기에 작업 전 사용자 유형 범위를 넓혀 두는것이 좋다. 

내 경우 아예 Monday 관리자로 셋팅하여 모든 보드를 볼 수 있는 권한을 부여 했다.  

2. API v2 토큰 발급 

관리 > API 로 이동하면 API v2 토큰 발급이 가능하다. 

생성된 토큰으로 통신할 예정이니 해당 토큰 발급은 미리 해두는게 좋다 

3. 개발자 모드에서 API Test 가능 

API 토큰까지 발급하고 나면, 개발자 모드를 체험할 차례이다. 

개발자 모드를 접속 후

개발자 API 플레이그라운드로 접속하면 내가 만든 쿼리를 테스트 해볼 수 있는 공간이 나온다. 

여기까지 셋팅하였다면, Monday API를 체험할 준비가 완료 된 것이다. 

이 뒤부터는 실제 쿼리를 다루는 법을 작성해 볼 예정이다. 

 

참고사이트:

https://developer.monday.com/api-reference/docs

monday.com GraphQL API