WebService::JugemKey::Auth - Perl interface to the JugemKey Authentication API
Version 0.04
use WebService::JugemKey::Auth; my $api = WebService::JugemKey::Auth->new({ api_key => '...', secret => '...', }); # create login uri my $uri = $api->uri_to_login({ callback_url => 'http://your_callback_url_here/', param1 => 'value1', param2 => 'value2', }); print $uri->as_string; # exchange frob for token my $frob = $q->param('frob'); my $user = $api->get_token($frob) or die "Couldn't get token: " . $api->errstr; $user->name; $user->token; # get user info from token my $user = $api->get_user($token) or die "Couldn't get user: " . $api->errstr; $user->name;
A simple interface for using the JugemKey Auththentication API. http://jugemkey.jp/api/auth/
Contructs a WerbService::JugemKey::Auth object.It requires 'api_key' and 'secret' you can get from the JugemKey web site. (https://secure.jugemkey.jp/?mode=auth_top)
Returns a URI object that points the JugemKey login url with required parameters. You must specify callback_url parameter like this.
uri_to_login({ callback_url => 'http://your_callback_url/' })
If you need a query string with the callback_url, you can specify it like this.
uri_to_login({ callback_url => 'http://your_callback_url/', param1 => 'value1', param2 => 'value2', })
In this example, a JugemKey user returns to http://your_callback_url/?param1=value1¶m2=value2&frob=xxxxxxxxxxxxxxxx after authenticated by the JugemKey.A frob is used for getting a token and a user information.
Passes a frob to the JugemKey Auth API and returns a WebService::JugemKey::Auth::User object associated with the JugemKey user.This user object has some accessors for getting JugemKey user information.
Returns an account name on the JugemKey.
Returns a token associated with the JugemKey logged-in user. You can use this token for getting a user information again or authenticating with other paperboy&co. Web Service APIs.
Passes a token to the JugemKey Auth API and returns a WebService::JugemKey::Auth::User object associated with the JugemKey user.This user object has some accessors for getting JugemKey user information.
Generates a message authentication code with HMAC_SHA1.
Set/Get a user-agent name.
JugemKey Authentication API http://jugemkey.jp/api/auth/
This module's interface and code are inspired by Hatena::API::Auth. Thanks to Naoya Ito and Hatena.
Gosuke Miyashita, <gosukenator at gmail.com>
<gosukenator at gmail.com>
Please report any bugs or feature requests to bug-webservice-jugemkey-auth at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WebService-JugemKey-Auth. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-webservice-jugemkey-auth at rt.cpan.org
You can find documentation for this module with the perldoc command.
perldoc WebService::JugemKey::Auth
You can also look for information at:
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/WebService-JugemKey-Auth
CPAN Ratings
http://cpanratings.perl.org/d/WebService-JugemKey-Auth
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=WebService-JugemKey-Auth
Search CPAN
http://search.cpan.org/dist/WebService-JugemKey-Auth
Copyright 2006 paperboy&co., all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install WebService::JugemKey::Auth, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WebService::JugemKey::Auth
CPAN shell
perl -MCPAN -e shell install WebService::JugemKey::Auth
For more information on module installation, please visit the detailed CPAN module installation guide.