NAME

WWW::GoodData - Client library for GoodData REST-ful API

SYNOPSIS

use WWW::GoodData;
my $gdc = new WWW::GoodData;
print $gdc->uri ('md', { title => 'My Project' });

DESCRIPTION

WWW::GoodData is the client for GoodData JSON-based API built atop WWW::GoodData::Agent client agent, with focus on usefullness and correctness of implementation.

It provides code for navigating the REST-ful API structure as well as wrapper funcitons for common actions.

METHODS

new [PARAMS]

Create a new client instance.

You can optionally pass a hash reference with properties that would be blessed, otherwise a new one is created. Possible properties include:

agent

A WWW::GoodData::Agent instance to use.

Traverse the links in resource hierarchy following given PATH, starting from API root ("gdc" by default).

PATH is an array of dictionaries, where each key-value pair matches properties of a link. If a plain string is specified, it is considered to be a match against category property:

$gdc->get_links ('md', { 'category' => 'projects' });

The above call returns a list of all projects, with links to their metadata resources.

get_uri PATH

Follows the same samentics as links() call, but returns an URI of the first matching resource instead of complete link structure.

login EMAIL PASSWORD

Obtain a SST (login token).

projects

Return array of links to project resources on metadata server.

SEE ALSO

COPYRIGHT

Copyright 2011, Lubomir Rintel

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

AUTHOR

Lubomir Rintel lkundrak@v3.sk