はじめに
WrikeはRestful APIを公開しているので自己責任で使用可能です。
OATH2の認証がターミナルだと下記の手順で面倒なのでとりあえずPostmanでTokenを取得してAPIを叩けるようにする方法です。
Wrike API公式ドキュメント（英語のみ）
OAuth 2.0に関してのドキュメント（英語のみ）
ターミナルで叩いてみる場合
- Wrike側でAPI使用の許可→Client ID、Crient Secretの取得
- Client IDを使ってauthorization Code取得
- Client ID, Secret, Auth codeつかってToken取得
- Tokenつかってデータを取得
となります。
詳しくは↑のOAuth 2.0の公式ドキュメント参照
Postmanで行う場合は
- Wrike側でAPI使用の許可→Client ID、Crient Secretの取得
- Postmanをインストール
- Postmanで新たにOAuth2設定し、Tokenを取得する
- WrikeのAPIを叩いてみる。
となります。
早速やってみましょー。
①Wrike側でAPI使用の許可→Client ID、Crient Secretの取得
アプリ登録と言ったりもします。
- Wrikeの右上にある自分のアイコンをクリックし、『アプリ＆統合』をクリック
- 左ペインにあるAPIをクリックし、アプリ名に任意の名前を入力し『新規作成』をクリック
- こちらで発行されるClient ID、Client 情報（Client secretです）を書き留める。リダイレクトはローカル開発なのでデフォルトで保存をクリック。永久アクセストークンはここではテストのため不使用です。
②Postmanをインストール
- Postmanのインストールは本家Webサイトからか、Macの場合はHomebrewからのインストール。
% brew install postman
その後はPostmanのアカウント作ってください
③Postmanで新たにOAuth2設定し、Tokenを取得する
1.Postmanを開いて+ボタンをクリックして新規作成
2.認証設定を行う
Authorizationタブをクリック
TYPE：OAuth 2.0 ＆ Add authorization data to：Request URLを選択
各種パラメーターを下記のように設定し、下部にある『Get new Access Token』をクリック
| キー | 値 |
|---|---|
| Token Name | 適当 |
| Callback URL | http://localhost |
| A uth URL | https://login.wrike.com/oauth2/authorize/v4 |
| Access Token URL | https://login.wrike.com/oauth2/token |
| Client ID | さきほどメモっといたやつ |
| Client Secret | 同様 |
| Scopeは使いたいAPIに対応するScope（今回はユーザー情報をとるためのemailを設定） | |
 |
|
| 3.Wrikeの認証へ飛ぶのでID、Passを入力したあと出てきた画面でAcceptをクリック |
ID
Pass
Accept
4.Postmanへ画面がもどるのでProceedをクリック
5.Use tokenをクリック
6.データ取得してみる
Get：https://www.wrike.com/api/v4/contacts?me=true
ここまで行けばGetでTaskなり、フォルダなり、カスタムフィールドなりGetしてみてください。Put、Deleteつかって操作も可能です。
Get https://www.wrike.com/api/v4/tasks
Get https://www.wrike.com/api/v4/folders
Get https://www.wrike.com/api/v4/customfields
Postmanですが、右上のSaveをクリックすると作成したプロジェクト？がセーブできますし、アカウント作っていればクラウド上に保存されます。次回からはGet New Access Token叩いてWrikeの認証さえすればすぐ使えるようになります。