NAME

JSON::RPC::Simple::Lite - A simple and lite JSON-RPC client.

DESCRIPTION

JSON::RPC::Simple::Lite provides a simple interface for JSON-RPC APIs. It uses HTTP::Tiny for the backend transfer and supports all the interfaces that library does.

USAGE

JSON::RPC::Simple::Lite;

my $api_url = "https://www.perturb.org/api/json-rpc/";
my $opts    = { debug => 0 };
my $json    = JSON::RPC::Simple::Lite->new($api_url, $opts);

# Direct using _call()
my $resp = $json->_call($method, @params);

# OOP style using chaining and AUTOLOAD magic
my $str = $json->echo_data("Hello world!");
my $num = $json->math->sum(1, 4);

# Get the curl command for this call
my $curl_str = $json->curl_call($method, @params);

FUNCTIONS

_call($method, @params)

Call the remote function $method passing it @params. The return value is the response from the server.

curl_call($method, @params)

Returns a string that represents a command line Curl call of $method. This can be useful for debugging and testing.

OBJECT ORIENTED INTERFACE

JSON::RPC::Simple::Lite allows a pseudo OOP interface using AUTOLOAD. This allows you to chain calls in different namespaces together which gets mapped to the correct method name before calling.

$json->user->email->login($user, $pass); # Maps to method 'user.email.login'

This format can make your code cleaner and easier to read.

Note: This does require that your final method include some parameter. If your function does not require any params pass undef or use the explicit _call() method.

DEBUG

If debug is passed in via the constructor options JSON information will be printed to STDOUT.

AUTHORS

Scott Baker - https://www.perturb.org/