Trello API を使ったコマンドラインツールを作りたい
って事で Trello API を読みながら模索中.
Token
見たところ Trello は GitHub のように直接 token を生成する手段が無いみたいなので api key を取得して,そこから token を取得のための認証ページに遷移する URL を生成する必要があるみたい.
API Key の取得
まず API を使うには認証が必要になるので
https://trello.com/1/appKey/generate
にアクセスして api key を取得する.
api key と一緒に secret も取得できるけど,今のところ必要そうな感じはしない...
Token の取得
次に取得した api key 等の情報を元に token のリクエストを行うのだけども,
OAuth はユーザによる認証が必要になるのでコマンドラインツールだけでは簡潔させられない.
今回は api key を設定したらそこからURLを生成するスクリプトを作って手動で頑張る事に.
https://gist.github.com/da0shi/41ff723e8cdc39725f72#file-tokenrequesturi
スクリプト内で設定されているパラメーターは
-
key
: 取得した API Key -
name
: アプリケーションの名前 -
expiration
: token の失効期限
設定できる期間は4種類で,never に設定すれば失効する事が無くなる- 1hour
- 1day
- 30days
- never`
-
scope
: token の有効範囲
,
区切りで並べることで複数の範囲を指定可能- read
- write
- account
-
response_type
: OAuth 上で必要となるパラメーター
基本的に "token" でいいみたい.ここは別途調べねば... [UpdateMe]
その他にも
-
callback_method
: 認証ページの表示方法- postMessage: ポップアップ
- fragment: リダイレクト
-
return_url
: 俗にいう Callback URL.認証後に飛ばすページを設定する.
生成した URL にアクセスすると認証ページが表示されるのでそこを認証すると
You have granted access to your Trello information.
To complete the process, please give this token:
{Your Application Token}
というページが表示されて token が取得できる.
return_url を設定すると指定された URL に token
という名前のパラメーターが付与されて返ってくる.
とりあえず Trello の token 取得についてはこんな感じ
ちなみに自分が認証した token に関しては
https://trello.com/{username}/account
のページにアクセスすると確認,取り消しができるようになっている.
{username}
の部分は自分のユーザ名に置き換えてくださいな