/net-http-api

Easily create client for HTTP API

Primary LanguagePerl

Net::HTTP::API

SYNOPSIS

package My::Net::API;
use Net::HTTP::API;

# we declare the API meta:
# - api_base_url   : url that will be our base
# - api_format     : what's the format for this API
# - api_format_mode: how do we set the format

net_api_declare twitter => (
    api_base_url    => 'http://search.twitter.com/',
    api_format      => 'json',
    api_format_mode => 'append',
);

# we declare one method now:
# - method  : HTTP method
# - path    : path for the request
# - params  : list of params accepted for this request
# - required: list of required params

net_api_method search => (
    method   => 'GET',
    path     => '/search',
    params   => [qw/q lang local page/],
    required => [qw/q/],
);

1;

my $api = My::Net::API->new();
my $res = $api->search(q => 'Perl');

head1 DESCRIPTION

Net::HTTP::API is a module to help to easily create a client for a web API.

THIS MODULE IS IN ITS BETA QUALITY. THE API MAY CHANGE IN THE FUTURE