認可 (Authorization)

ユーザーの情報へアクセスするには、そのユーザーからアクセスの認可を得る必要があります。

※1 認可は不要

ここではOAuthによる方法について解説します。

アプリケーションの登録

Create an applicationでアプリケーションを登録します。登録したアプリケーションは、My applicationsで管理できます。

すでに使用されているアプリケーション名では登録できず、アプリケーションの説明は10文字以上である必要があります。

アプリケーションの登録に成功すると、アプリケーション管理ページのDetailsが表示されます。ここのOAuth settingsの項目で、Consumer keyとConsumer secretを取得できます。

アプリケーションを動作させるためには、Application typeの設定を確実に行う必要があります。これはアプリケーション管理ページの[Settings]タブにあります。

アプリケーションが必要とするアクセスの種類を指定します。Permission levelには、

の3レベルがあり、それぞれ次のようにアクセスできる情報が異なります。

許可内容	Read only	Read and Write	Read, Write and Access direct messages
タイムラインのツイートを見る	○	○	○
フォローしている人を見る	○	○	○
新しくフォローする	×	○	○
プロフィールを更新する	×	○	○
ツイートする	×	○	○
ダイレクトメッセージを見る	×	×	○
Twitterのパスワードを見る	×	×	×

アプリケーションを登録するときには、不要であっても必ずCallback URLに値を設定しておきます。さもなくばリクエストトークンの取得時に、

<error>Desktop applications only support the oauth_callback value 'oob'</error>

と返されます。

Callback URLは、Application Typeの[Callback URL]で設定します。実際にCallbackさせるURLはアプリケーション上で指定できるため、ここのURLは任意で構いません。たとえばhttp://example.com/でも問題ありません。

My applicationsで削除対象のアプリケーションを開き、上部の[Delete]をクリックします。

次の手順によりアクセストークンを取得します。

現状ではアクセストークンに有効期限はありません。OAuth FAQ | Twitter Developers

認可の処理は煩雑であるため、これを簡単に行うためのライブラリが提供されています。