# OAuth::getRequestToken

(PECL OAuth >= 0.99.1)

OAuth::getRequestToken — Obtiene un token de petición

### Descripción

public OAuth::getRequestToken(string `$request_token_url`, string `$callback_url` = ?, string `$http_method` = ?): array

Obtiene un token de petición, secreto y cualquier parámetro adicional de respuesta del proveedor de servicio.

### Parámetros

`request_token_url`

  URL al token de solicitud de la API.

`callback_url`

  URL del callback OAuth. Si `callback_url` es pasado y es un valor vacío, este es puesto a "oob" para satisfacer las exigencias de OAuth 2009.1 advisory.

`http_method`

  Método HTTP a usar, por ejemplo `GET` o `POST`.

### Valores devueltos

Devuelve un array conteniendo las respuestas OAuth analizadas al tener éxitoo `false` al fallar.

### Historial de cambios

Versión | Descripción
--- | ---
1.0.0 | Antes devolvía `null` en caso de falla, en lugar de `false`.
0.99.9 | El parámetro `callback_url` fue agregado

### Ejemplos

Ejemplo #1 Ejemplo de OAuth::getRequestToken()

`<?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 "Falló obteniendo el token de petición, la respuesta fue: " . $oauth->getLastResponse();
}
} catch(OAuthException $E) {
echo "Respuesta: ". $E->lastResponse . "\n";
}
?>`

El resultado del ejemplo sería algo similar a:

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

### Ver también

- OAuth::getLastResponse() - Obtiene la última respuesta
- OAuth::getLastResponseInfo() - Obtiene la información HTTP sobre la última respuesta