NAME

Webservice::Instagram - Simple Interface to Instagram oAuth API

VERSION

Version 0.01

SYNOPSIS

Step 1:

Get the AUTH URL to authenticate,

use Webservice::Instagram;

my $instagram = Webservice::Instagram->new( { client_id => 'xxxxxxxxxxxxxxx', client_secret => 'xxxxxxxxxxxxxxx', redirect_uri => 'http://domain.com', grant_type => 'authorization_code' } );

my $auth_url = $obj->get_auth_url(); print Dumper $auth_url; >

Step 2: Go to the above calculated URL in the browser, authenticate and fetch the code returned by the browser after authentication. The returned URL is usually of the form www.returnuri.com/?code=xxxxxxxxxxx

Step 3:

Now using the code, fetch the access_token and set it to the object,

my $access_token = $obj-get_access_token( $code ); #$code is fetched from Step 2. #Set the access_token to $instagram object $instagram->set_access_token( $access_token ); >

Step 3: Fetch resource using the object.

my $search_result = $obj-get( 'https://api.instagram.com/v1/users/search', { q => 'ravi' } }; >

SUBROUTINES/METHODS

get_auth_url

Returns the authorization URL that the user has to authorize against. Once authorized, the browser appends the code along to the redirect URL which will used for obtaining access_token later.

get_access_token

Once you have the code, you are ready to get the access_token.

get

Since you now have the access token, you can request all the resources on behalf of the API.

AUTHOR

Daya Sagar Nune, <dayanune at cpan.org>

BUGS

Please report any bugs or feature requests to bug-webservice-instagram at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Webservice-Instagram. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Webservice::Instagram

You can also look for information at:

• RT: CPAN's request tracker (report bugs here)

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Webservice-Instagram

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Webservice-Instagram

• CPAN Ratings

  http://cpanratings.perl.org/d/Webservice-Instagram

• Search CPAN

  http://search.cpan.org/dist/Webservice-Instagram/

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2013 Daya Sagar Nune.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

cpanm Webservice::Instagram

perl -MCPAN -e shell
install Webservice::Instagram