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.
- links PATH
-
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
https://secure.gooddata.com/gdc/ -- Browsable GoodData API
WWW::GoodData::Agent -- GoodData API-aware user agent
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