OAuth::getRequestToken

Fetch a request token

&reftitle.description; public `array` `OAuth::getRequestToken` `string` `request_token_url` `string` `callback_url` `string` `http_method`

Fetch a request token, secret and any additional response parameters from the service provider.

&reftitle.parameters;

`request_token_url`

- URL to the request token API.

`callback_url`

- OAuth callback URL. If `callback_url` is passed and is an empty value, it is set to "oob" to address the OAuth 2009.1 advisory.

`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 `callback_url` parameter was added

&reftitle.examples;

### `OAuth::getRequestToken` example

    <?php
    try {
        $oauth = new OAuth(OAUTH_CONSUMER_KEY,OAUTH_CONSUMER_SECRET);
        $request_token_info = $oauth->getRequestToken("https://example.com/oauth/request_token");
        if(!empty($request_token_info)) {
            print_r($request_token_info);
        } else {
            print "Failed fetching request 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`