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.