/ 
WWW-GoodData-0.5
River stage zero No dependents
/ WWW::GoodData

NAME

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

SYNOPSIS

use WWW::GoodData;
my $gdc = new WWW::GoodData;
print $gdc->get_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.

delete_project IDENTIFIER

Delete a project given its identifier.

create_project TITLE SUMMARY

Create a project given its title and optionally summary, return its identifier.

reports PROJECT

Return array of links to repoort 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