登録済みアプリケーションにOAuth 2ベアラートークンを取得させます。OAuth 2ベアラートークンを使うと、ユーザーの資格情報を使わずにアプリケーションの情報のみでAPIリクエストを作成することができます。これは アプリケーション単独認証と呼ばれます。
ベアラートークンは oauth2/invalidate_tokenを使って無効にすることができます。ベアラートークンが無効になると、別のベアラートークンが新しく作成され、前のトークンを使用することはできなくなります。
一つのアプリケーションで使えるベアラートークンは一つだけなので、ベアラートークンを無効にしなければこのメソッドを何度リクエストしても既に作成済みのトークンを同じものが生成されます。
全てのAPI v1.1 メソッドと同じように、常に HTTPS での接続が必須です。
成功時の応答には、付与されたベアラートークンの詳細をJSON-構造で記載した情報が含まれています。
このメソッドで取得したトークンはどこかに保存しておくようにしてください。このメソッドを頻繁にリクエストしすぎると、リクエストが拒否されてコード99の HTTP 403 エラーが返されます。
POST oauth2/
|
https://api.twitter.com/oauth2/token
Resource URL
|
Resource Information
Response formats
JSON
Requires authentication?
Yes
Rate limited?
Yes
|
このメソッドを使用する方法については アプリケーション単独認証を参照してください。
アプリケーションが要求している承認の種類を設定します。現時点では、 client_credentials のみが設定できます。
詳細情報についてはアプリケーション単独認証を参照してください。
サンプル値: client_credentials
ParametersSee Application-Only Authentication for instructions on how to use this method.
grant_type
required
Specifies the type of grant being requested by the application. At this time, only Example Values: |
ログイン して登録アプリケーションの一覧を参照してください。
OAuth Signature GeneratorSign in to see a list of your registered applications. |
POST /oauth2/token HTTP/1.1 Host: api.twitter.com User-Agent: My Twitter App v1.0.23 Authorization: Basic eHZ6MWV2R ... o4OERSZHlPZw== Content-Type: application/x-www-form-urlencoded;charset=UTF-8 Content-Length: 29 Accept-Encoding: gzip grant_type=client_credentials
応答例:
HTTP/1.1 200 OK
Status: 200 OK
Content-Type: application/json; charset=utf-8
...
Content-Encoding: gzip
Content-Length: 140
{"token_type":"bearer","access_token":"AAAA%2FAAA%3DAAAAAAAA"}
Example ResultPOST /oauth2/token HTTP/1.1 Host: api.twitter.com User-Agent: My Twitter App v1.0.23 Authorization: Basic eHZ6MWV2R ... o4OERSZHlPZw== Content-Type: application/x-www-form-urlencoded;charset=UTF-8 Content-Length: 29 Accept-Encoding: gzip grant_type=client_credentials Example response: HTTP/1.1 200 OK
Status: 200 OK
Content-Type: application/json; charset=utf-8
...
Content-Encoding: gzip
Content-Length: 140
{"token_type":"bearer","access_token":"AAAA%2FAAA%3DAAAAAAAA"}
|