OAuth::getAccessToken

Fetch an access token

&reftitle.description; public `array` `OAuth::getAccessToken` `string` `access_token_url` `string` `auth_session_handle` `string` `verifier_token` `string` `http_method`

Fetch an access token, secret and any additional response parameters from the service provider.

&reftitle.parameters;

`access_token_url`

- URL to the access token API.

`auth_session_handle`

- Authorization session handle, this parameter does not have any citation in the core OAuth 1.0 specification but may be implemented by large providers. See ScalableOAuth for more information.

`verifier_token`

- For service providers which support 1.0a, a `verifier_token` must be passed while exchanging the request token for the access token. If the `verifier_token` is present in `$_GET` or `$_POST` it is passed automatically and the caller does not need to specify a `verifier_token` (usually if the access token is exchanged at the oauth_callback URL). See ScalableOAuth for more information.

`http_method`

- HTTP method to use, e.g. `GET` or `POST`.

&reftitle.returnvalues;

Returns an array containing the parsed OAuth response on success or &false; on failure.

&reftitle.changelog;

&Version; | &Description;
PECL oauth 1.0.0 | &oauth.changelog.error.null;
PECL oauth 0.99.9 | The `verifier_token` parameter was added

&reftitle.examples;

### `OAuth::getAccessToken` example

    <?php
    try {
        $oauth = new OAuth(OAUTH_CONSUMER_KEY,OAUTH_CONSUMER_SECRET);
        $oauth->setToken($request_token,$request_token_secret);
        $access_token_info = $oauth->getAccessToken("https://example.com/oauth/access_token");
        if(!empty($access_token_info)) {
            print_r($access_token_info);
        } else {
            print "Failed fetching access token, response was: " . $oauth->getLastResponse();
        }
    } catch(OAuthException $E) {
        echo "Response: ". $E->lastResponse . "\n";
    }
    ?>

&example.outputs.similar;

    Array
    (
        [oauth_token] => some_token
        [oauth_token_secret] => some_token_secret
    )

&reftitle.seealso;

- `OAuth::getLastResponse`
- `OAuth::getLastResponseInfo`
- `OAuth::setToken`