WebService::Fastly::Role - a Moose role for the Fastly API
Automatically generated:
This role is the only component of the library that uses Moose. See WebService::Fastly::ApiFactory for non-Moosey usage.
This module provides an interface to the generated library. All the classes, objects, and methods (well, not quite *all*, see below) are flattened into this role.
package MyApp; use Moose; with 'WebService::Fastly::Role'; package main; my $api = MyApp->new({ tokens => $tokens }); my $pet = $api->get_pet_by_id(pet_id => $pet_id);
The library consists of a set of API classes, one for each endpoint. These APIs implement the method calls available on each endpoint.
Additionally, there is a set of "object" classes, which represent the objects returned by and sent to the methods on the endpoints.
An API factory class is provided, which builds instances of each endpoint API.
This Moose role flattens all the methods from the endpoint APIs onto the consuming class. It also provides methods to retrieve the endpoint API objects, and the API factory object, should you need it.
For documentation of all these methods, see AUTOMATIC DOCUMENTATION below.
In the normal case, the API Spec will describe what parameters are required and where to put them. You just need to supply the tokens.
my $tokens = { # basic username => $username, password => $password, # oauth access_token => $oauth_token, # keys $some_key => { token => $token, prefix => $prefix, in => $in, # 'head||query', }, $another => { token => $token, prefix => $prefix, in => $in, # 'head||query', }, ..., }; my $api = MyApp->new({ tokens => $tokens });
Note these are all optional, as are prefix and in, and depend on the API you are accessing. Usually prefix and in will be determined by the code generator from the spec and you will not need to set them at run time. If not, in will default to 'head' and prefix to the empty string.
prefix
in
The tokens will be placed in a WebService::Fastly::Configuration instance as follows, but you don't need to know about this.
$cfg-\
String. The username for basic auth.
String. The password for basic auth.
Hashref. Keyed on the name of each key (there can be multiple tokens).
$cfg->{api_key} = { secretKey => 'aaaabbbbccccdddd', anotherKey => '1111222233334444', };
$cfg-
Hashref. Keyed on the name of each key (there can be multiple tokens). Note not all api keys require a prefix.
$cfg->{api_key_prefix} = { secretKey => 'string', anotherKey => 'same or some other string', };
$config-\
String. The OAuth access token.
base_url
The generated code has the base_url already set as a default value. This method returns the current value of base_url.
api_factory
Returns an API factory object. You probably won't need to call this directly.
$self->api_factory('Pet'); # returns a WebService::Fastly::PetApi instance $self->pet_api; # the same
Most of the methods on the API are delegated to individual endpoint API objects (e.g. Pet API, Store API, User API etc). Where different endpoint APIs use the same method name (e.g. new()), these methods can't be delegated. So you need to call $api->pet_api->new().
new()
$api->pet_api->new()
In principle, every API is susceptible to the presence of a few, random, undelegatable method names. In practice, because of the way method names are constructed, it's unlikely in general that any methods will be undelegatable, except for:
new() class_documentation() method_documentation()
To call these methods, you need to get a handle on the relevant object, either by calling $api->foo_api or by retrieving an object, e.g. $api->get_pet_by_id(pet_id => $pet_id). They are class methods, so you could also call them on class names.
$api->foo_api
$api->get_pet_by_id(pet_id => $pet_id)
You can print out a summary of the generated API by running the included autodoc script in the bin directory of your generated library. A few output formats are supported:
autodoc
bin
Usage: autodoc [OPTION] -w wide format (default) -n narrow format -p POD format -H HTML format -m Markdown format -h print this help message -c your application class
The -c option allows you to load and inspect your own application. A dummy namespace is used if you don't supply your own class.
-c
Additional documentation for each class and method may be provided by the API spec. If so, this is available via the class_documentation() and method_documentation() methods on each generated object class, and the method_documentation() method on the endpoint API classes:
class_documentation()
method_documentation()
my $cmdoc = $api->pet_api->method_documentation->{$method_name}; my $odoc = $api->get_pet_by_id->(pet_id => $pet_id)->class_documentation; my $omdoc = $api->get_pet_by_id->(pet_id => $pet_id)->method_documentation->{method_name};
Each of these calls returns a hashref with various useful pieces of information.
1 POD Error
The following errors were encountered while parsing the POD:
=over should be: '=over' or '=over positive_number'
To install WebService::Fastly, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WebService::Fastly
CPAN shell
perl -MCPAN -e shell install WebService::Fastly
For more information on module installation, please visit the detailed CPAN module installation guide.