Chatwork API 토큰 발급 및 실행 방법 요약

API Token 준비

채팅 작업 오른쪽 상단의 프로필 이미지 메뉴에서 'API 설정'을 선택합니다.



API Token 페이지가 열리므로 채팅 작업의 비밀번호를 입력하여 인증합니다.
그러면 토큰 문자열이 표시됩니다.



※매우 소중한 문자열이므로 취급에 주의해 주십시오.
※토큰 발행에는 관리자의 허가가 필요한 경우도 있습니다.

postman 준비

Postman
이번에는 GUI 실행으로 알기 쉽게 postman이라는 도구를 사용합니다.
post나 get의 http의 실행을 간단하게 실시할 수 있습니다.
물론 명령에서 실행해도 전혀 문제 없습니다.

막상 실행

엔드포인트 설정

https://api.chatwork.com/v2현재 (2019/12 시점)에서는 API 버전이 version2이므로 v2입니다.

이번에는 예로 계정의 토큰을 사용하여 메시지를 던지는 API를 실행하고 싶습니다.

여기를 아래 그림의 부분으로 설정합니다.https://api.chatwork.com/v2/rooms/{マイチャットのroomID}/messages

http header 설정

HTTP 요청 헤더에 X-ChatWorkToken 라는 키로 value에 발행한 토큰을 설정합니다.
그리고 Content-Type 는 application/x-www-form-urlencoded 를 설정합니다.

body 설정

여기는 API 인터페이스에 맞게 값을 지정하기 만하면됩니다.
이번 메시지 통지는 body 라는 key로 value에 문자열로 메시지를 넣습니다.

실행

여기까지 설정하고 나머지는 Send 로 실행하기만 하면 됩니다.
실행하면 응답으로 message_id가 반환됩니다.
자신의 채팅에 메시지가 날아오면 성공입니다.
오류가 발생하면 설정과 토큰을 검토해 보십시오.

생각보다 쉽지 않았을까요?
API를 활용하여 시스템 연계 등 시키면 편리하므로 꼭 활용하십시오.

API 문서