The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

NAME

WebService::Simple - Simple interface to Web Services APIs

VERSION

This document describes WebService::Simple version 0.03

SYNOPSIS

my $flickr = WebService::Simple->new(
param => { api_key => "your_api_key", }
);
my $response =
$flickr->get( { method => "flickr.test.echo", name => "value" } );
my $ref = $response->parse_xml( { forcearray => [], keyattr => [] } );
print $ref->{name} . "\n";

DESCRIPTION

WebService::Simple provides you a simple interface to Web Services APIs

METHODS

new(%args)
my $flickr = WebService::Simple->new(
param => { api_key => "your_api_key", }
);

Create and return a new WebService::Simple object. "new" Method requires a base_url of Web Service API.

get(%args)
my $response =
$flickr->get( { method => "flickr.test.echo", name => "value" } );

Get the WebService::Simple::Response object.

If you want to add a path to base URL, use an option parameter.

my $lingr = WebService::Simple->new(
base_url => "http://www.lingr.com/",
param => { api_key => "your_api_key", format => "xml" }
);
my $response = $lingr->get( {}, { path => "/api/session/create" } );

CACHING

Cache the response of Web Service APIs by using Cache object. Here's an example.

my $cache = Cache::File->new(
cache_root => "/tmp/mycache",
default_expires => "30 min",
);
my $flickr = WebService::Simple->new(
cache => $cache,
param => { api_key => $api_key, }
);

AUTHOR

Yusuke Wada <yusuke@kamawada.com>

COPYRIGHT AND LISENCE

Copyright (c) 2008 Yusuke Wada, All rights reserved.

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