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.