NAME

YellowBot::API - The great new YellowBot::API!

SYNOPSIS

use YellowBot::API;

my $api = YellowBot::API->new
   (api_key    => $api_key,
    api_secret => $api_secret,
   );

# if you are in Canada...
# $api->server('http://www.weblocal.ca/');

my $data = $api->call('location/details',
                      id           => '/solfo-burbank-ca.html'
                      api_version  => 1,
                      get_pictures => 10,
                     );
print $data->{name}, "\n";
for my $p ( @{ $data->{pictures} } ) {
   print $p->{url}, "\n";
}


my $signin_url = $api->signin_url(
   domain => 'reputation.example.com',
   api_user_identifier => 'abc123',
   brand => 'yellowbot',
);

METHODS

call( $endpoint, %args )

Calls the endpoint (see the YellowBot API documentation) with the specified arguments. Returns a hash data structure with the API results.

signin_url( %options )

Generate a URL for the "silent partner login" feature. See example above and API documentation for details.

DEBUGGING

If the API_DEBUG environment variable is set to a true value (1 for example) the request query and the response will be printed to STDERR.

See also the ybapi utility, ybapi.

AUTHOR

Ask Bjørn Hansen, <ask at develooper.com>

BUGS

Please report any bugs or feature requests to the issue tracker at http://github.com/solfo/YellowBot-API-perl/issues.

The Git repository is available at http://github.com/solfo/YellowBot-API-perl (Clone with git clone http://github.com/solfo/YellowBot-API-perl.git).

COPYRIGHT & LICENSE

Copyright 2009-2010 Solfo, Inc, all rights reserved.

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