Alexander Babenko > OAuth-Simple-0.15 > OAuth::Simple

Download:
OAuth-Simple-0.15.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.15   Source   Latest Release: OAuth-Simple-1.01

NAME ^

OAuth::Simple - Simple OAuth authorization on your site

SYNOPSIS ^

  my $oauth = OAuth::Simple->new(
      app_id     => 'YOUR APP ID',
      secret     => 'YOUR APP SECRET',
      postback   => 'POSTBACK URL',
  );
  my $url = $oauth->authorize( {url => 'https://www.facebook.com/dialog/oauth', scope => 'email', response_type => 'code'} );
  # Your web app redirect method.
  $self->redirect($url);
  # Get access_token.
  # Facebook returns data not in JSON. Use the raw mode and parse.
  my $access = $oauth->request_access_token( {url => 'https://graph.facebook.com/oauth/access_token', code => $args->{code}, raw => 1} );
  # Get user profile data.
  my $profile_data = $oauth->request_data( {url => 'https://graph.facebook.com/me', access_token => $access} );  

DESCRIPTION ^

Use this module for input VK OAuth authorization on your site

METHODS ^

new

  my $oauth = OAuth::Simple->new(
      app_id     => 'YOUR APP ID',
      secret     => 'YOUR APP SECRET',
      postback   => 'POSTBACK URL',
  );

The new constructor lets you create a new OAuth::Simple object.

authorize

        my $url = $oauth->authorize( {url => $authorize_server_url, option => 'value'} );
        # Your web app redirect method.
        $self->redirect($url);

This method returns a URL, for which you want to redirect the user.

Options

See information about options on your OAuth server.

Response

Method returns URI object.

request_access_token

  my $access = $oauth->request_access_token( {url => $server_url, code => $args->{code}} );

This method gets access token from OAuth server.

Options

* code - returned in redirected get request from authorize API method; * raw - do not decode JSON, return raw data; * http_method - set http method: GET(default), POST, etc.

Response

Method returns HASH object.

request_data

  my $profile_data = $oauth->request(
      url          => $api_method_url,
      access_token => $access_token,
      raw          => 1,
      http_method  => 'POST',
      }
  );

This method sends requests to OAuth server.

Options

* url (required) - api method url; * params (not required) - other custom params on OAuth server; * access_token (required) - access token; * raw - do not decode JSON, return raw data (default 0); * http_method - set http method: GET(default), POST, etc.

Response

Method returns HASH object with requested data.

prepare_http_request

Returns HTTP::Request object.

SUPPORT ^

Github: https://github.com/Foxcool/OAuth-Simple

Bugs & Issues: https://github.com/Foxcool/OAuth-Simple/issues

AUTHOR ^

Copyright 2012 Alexander Babenko.

syntax highlighting: