NAME
WebService::Simple - Simple interface to Web Services APIs
VERSION
This document describes WebService::Simple version 0.03
SYNOPSIS
use
WebService::Simple;
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
=> [] } );
$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(
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.