Access Providers APIs

Once a user is authenticated with an OAuth1 or OAuth2 provider, and depending on the authorization given to your application, you should be able to query the that provider’s API in behalf of the connected user.

For this you can call the method apiRequest on a connected adapter instance, and it’s defined as follows:

function apiRequest(string $url [, string $method [, array $parameters [, array $headers [, bool $multipart]]]])

Parameter	Type	Description
`$url`	string	Required: Relative or absolute url to API’s action.
`$method`	string	Optional: HTTP method. It can be either GET or POST, and defaults to GET.
`$parameters`	array	Optional: HTTP GET parameters or POST data as an associative array.
`$headers`	array	Optional: HTTP REQUEST Headers as an associative array.
`$multipart`	bool	Optional: If HTTP request should be sent as `multipart/form-data`, used when uploading images/videos

OpenID being a decentralized authentication protocol and not an authorization standard, its adapters do not communicate with providers APIs and therefore you cannot perform any action in behalf of authenticated user, and Hybridauth will throw NotImplementedException when apiRequest is called. To know more about providers specs and capabilities, refer to Supported Providers .

Usage

Below is a simple example of how to access GitHub’s API.

// Instantiate GitHub's adapter
$github = new Hybridauth\Provider\GitHub($config);

// Authenticate the user
$github->authenticate();

// Access GitHub API to retrieve the user's public gists.
// See: https://developer.github.com/v3/gists/
$apiResponse = $github->apiRequest('gists'); // or absolute url: https://api.github.com/gists

// Inspect API's response.
var_dump($apiResponse);

Another simple example of how to access Twitter’s API.

// Instantiate Twitter's adapter
$twitter = new Hybridauth\Provider\Twitter($config);

// Authenticate the user
$twitter->authenticate();

// Access Twitter's API to post a status update
// See: https://dev.twitter.com/rest/reference/post/statuses/update
$apiResponse = $twitter->apiRequest('statuses/update.json', 'POST', ['status' => 'This is tests!']);

// Inspect API's response.
var_dump($apiResponse);

Below is an example for uploading a video to a Facebook Page.

// Instantiate Facebook's adapter
$facebook = new Hybridauth\Provider\Facebook($config);

// Authenticate the user
$facebook->authenticate();

// Access Facebook's API to post a video
// See: https://developers.facebook.com/docs/graph-api/video-uploads/
$facebook->apiRequest('https://graph-video.facebook.com/PAGE_ID/videos',
                      'POST',
                      [
                          'title' => $videoTitle,
                          'description' => $videoDescription,
                          'source' => new \CURLFile($videoPath),
                      ],
                      [],
                      true
);

// Inspect API's response.
var_dump($apiResponse);