카테고리 없음

트렐로(trello) API 연동법

라미로 2018. 3. 17. 22:58

 

* 01. 왜 연동을 해야하는가?

- 트렐로를 단독으로 쓴다면 아무 문제가 없지만, 여러 협업 도구들을 섞어서 쓸 경우에는 오히려 도구 사용으로 인해 생산성에 
악 영향을 미칠 가능성이 있어, 한군데서 관리가 필요할 가능성 존재. ( EX : 이슈관리 도구 , 형상관리 도구, 테스트 도구 등 )

 

* 02. 트렐로 구조

- 우선 트렐로는 board > list >card > checklist 로 구분된다.
즉 첫번째에 board를 생성하고 그 다음에 TODO 나 DOEN 과 같은 list, 그리고 그 안에있는 card가 있고, card 안에있는 checklist 가 있다.

 

( 위와 같이 매치가 되고, checklist는 card 안에 존재한다 )

 

 

* 03. 연동 준비

- trello의 api는 REST 형식으로 지원하고있다.  그렇기 때문에 URL 방식으로 호출을 해야하는데,  아무래도 보드가 private 한 보드도 있다보니, 인증 절차가 필요하다.

즉, 아래와 같은 방식으로 보드의 정보를 확인 할 수 있으나,

// 보드정보 확인
https://api.trello.com/1/boards/[보드ID]

 

이렇게 그냥 연동하다가는 아래와 같은 401 에러를 뱉는다.

 

 

그러므로 key와 token을 받아야하는데,
https://trello.com/app-key/ 이곳을 들어가서 key 을 먼저 발급받고,
https://trello.com/1/authorize?key=[받은key]&name=trello-show&expiration=never&response_type=token  여기서 token을 발급받으면 된다.

 

당연한 말이지만, key와 토큰은 노출되지 않도록 주의할것

 

* 04. 연동

- 연동 자체는 매우 쉽다.

우선 url 뒤에 key와 token을 파라미터로 붙이면 되는데, 편의상 직접 url에 붙여서 테스트를 해도 상관없다.

 

// list 목록을 불러오는 예제

https://api.trello.com/1/boards/[BOARD ID]/lists?key=??&token=??

그렇게 하면 아래와 같이 list의 id값이 나온다.

[{"id":"5aad014d42943074b2f8908f","name":"할일(개인)","closed":false,"idBoard":"5aad014d42943074b2f8908e","pos":16384,"subscribed":false},{"id":"5aad014d42943074b2f89090","name":"진행중(개

 

// card 목록을 불러오는 예제
https://api.trello.com/1/lists/[BOARD ID]/cards?key=??&token=??

[{"id":"5aad151162f362916bbc7397","checkItemStates":null,"closed":false,"dateLastActivity":"2018-03-17T13:20:53.078Z","desc":"","descData":null,"idBoard":"5aad014d42943074b2f8908e","idList":"5aad014d42943074b2f8908f","idMembersVoted":[],"idShort":5,"idAttachmentCover":null,"idLabels":[],"manualCoverAttachment":false,"name":"[영어] 토익 공부(여름방

 

 

이와 같이 하위의 id를 순환하면 트렐로의 보드를 똑같이 만들고 관리할수있다.

인증 절차가 조금 복잡하지, 사용법은 간단하므로 나머지는 api 문서를 참고하면 될듯하다.

https://developers.trello.com/reference