NAME

Net::Douban - Perl client for douban.com

VERSION

version 1.07_1

SYNOPSIS

use Net::Douban;
use Net::Douban::OAuth;
my $consumer = Net::Douban::OAuth->new(...);
# do authentication here for protected data 
$consumer->request_token;
$consumer->access_token;

my $client = Net::Douban->new( oauth =>$consumer);

my $atom = $client->User(userID => 'Net-Douban')->get_user;
print $atom->id;
....

DESCRIPTION

Net::Douban is a perl client wrapper on the Chinese website 'douban.com' API.

METHODS

new
$client = Net::Douban->new(oauth => $consumer, apikey => $key);
Auto-Generated Objects
#Net::Douba::User object
$client->User;

#Net::Douban::Event object
$client->Event;
...

Auto-generated objects include: User Note Tag Collection Recommendation Event Review Subject Doumail Miniblog OAuth

Website data Access

Generally an apikey is required for you to access the douban.com service. Goto http://www.douban.com/service/apikey/ for an apikey

If you want to access some private or so called protected data, you have to use a authenticated oauth object, which has basic implements on the HTTP methods just like "GET POST PUT DELETE", to access the protected data, Net::Douban::OAuth can do this for you. Goto http://www.douban.com/service/apidoc/auth for more douban.com OAuth document.

We don't generate XML for you

If you want to post data to some page. Net::Douban::* can do the basic POST/DELETE/PUT works, but it won't generate any XML for you, so you have to call those methods with a (xml => $XML) argument;

Paging

Paging is support by passing argments 'start_index' and 'max_results' to search functions.

SEE ALSO

Net::Douban Net::Douban::Atom Net::Douban::OAuth Moose XML::Atom http://douban.com/service/apidoc

AUTHOR

woosley.xu<redicaps@gmail.com>

COPYRIGHT & LICENSE

This software is copyright (c) 2010 by woosley.xu.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.