NAME

Net::ZooTool - Moose interface to the Zootool API: http://zootool.com

SYNOPSIS

my $zoo = Net::ZooTool->new({ apikey   => $config{apikey} });

my $weekly_popular = $zoo->item->popular({ type => "week" });

# Info about a specific item
print Dumper($zoo->item->info({ uid => "6a80z" }));

# Examples with authenticated calls
my $auth_zoo = Net::ZooTool->new(
    {
        apikey   => $config{apikey},
        user     => $config{user},
        password => $config{password},
    }
);

my $data = $auth_zoo->user->validate({ username => $config{user}, login => 'true' });
print Dumper($data);

# In some methods authentication is optional.
# Public items only
my $public_items = $auth_zoo->user->items({ username => $config{user} });
# Include also your private items
my $all_items = $auth_zoo->user->items({ username => $config{user}, login => 'true' });

DESCRIPTION

Net::ZooTool is a wrapper to the Zootool bookmarking service. It attempts to follow the api defined in http://zootool.com/api/docs/general as much as possible. Please refer to their API Documentation site for more information.

PACKAGE METHODS

new(\%ARGS)

Create a new Net::ZooTool object.

Parameters:

• apikey

  string. Your Zootool apikey (required)

• user

  string. Your Zootool username (optional)

• password

  string. Your Zootool password (optional)

OBJECT METHODS

$zoo->user()

Net::ZooTool::User object

$zoo->item()

Net::ZooTool::Item object

$zoo->add(\%ARGS)

Adds a new item to your zoo (authentication is required).

Parameters:

• apikey

  string. Your Zootool api key (required)

• url

  string. Url to add (required)

• title

  string. Item title (required)

• tags

  string. Comma separated if you want to include more than one (optional)

• description

  string. Entry description (optional)

• referer

  string. Entry referer, must be a valid url (optional)

• public

  string. Whether or not the item is public ('y' or 'n')

• login

  boolean. Add method requires authenticated call (required)

$zoo->user->items(\%ARGS)

Get the latest items from all users or specify a username to get all items from a specific user. Authenticate to get all private items of a user as well. Use authentication if you want to get private items as well).

Parameters:

• apikey

  string. Your Zootool api key (required)

• username

  string. Zootool username (required)

• login

  string. must be true if you want to make an authenticated call via digest (optional).

• tag

  string. Tag search (optional)

• offset

  int. Search offset (optional)

• limit

  int. Search limit (optional)

• login

  boolean. Set to true to get private items as well.

$zoo->user->info(\%ARGS)

Get info about a certain user. Authentication is optional (if you want to get the email address from the user, you need to sign in).

Parameters:

• apikey

  string. Your Zootool api key (required)

• username

  string. Zootool username (required)

• login

  boolean. Set to true to get email address

$zoo->user->validate(\%ARGS)

Validate the user credentials. Useful for logins.

Parameters:

• apikey

  string. Your Zootool api key (required)

• username

  string. Your zootool username (required)

SEE ALSO

http://zootool.com/

http://zootool.com/api/docs

AUTHOR

Josep Roca, <quelcom@gmail.com>

COPYRIGHT AND LICENSE

Copyright (C) 2011 by Josep Roca

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.1 or, at your option, any later version of Perl 5 you may have available.