NAME

WebService::Pixela - It's https://pixe.la API client for Perl.

SYNOPSIS

use strict;
use warnings;

use WebService::Pixela;

# All WebService::Pixela methods use this token and user name in URI, JSON, etc.
my $pixela = WebService::Pixela->new(token => "thisissecret", username => "testname");

$pixela->user->create(); # default agreeTermsOfService and notMinor "yes"
# or...
$pixela->user->create(agree_terms_of_service => "yes", not_minor => "no"); # can input agreeTermsOfService and notMinor

my %graph_params = (
    name     => 'test_graph',
    unit     => 'test',
    type     => 'int',
    color    => 'shibafu',
    timezone => 'Asia/Tokyo',
);

print $pixela->graph->id('graph_id')->create(%graph_params)->{message} . "\n";

#return json text

my $json = $pixela->decode(0)->graph->get();
$pixela->decode(1);
$pixela->webhook->create(type => 'increment');

my $hash = $pixela->webhook->hash() . "\n";
my $pixel = $pixela->pixel->get(date => '20180915');

$pixela->user->delete(); # delete method not require arguments

DESCRIPTION

WebService::Pixela is API client about https://pixe.la

CI_PIXELA

ORIGINAL API DOCUMENT

INTERFACE

Class Methods

`WebService::Pixela->new(%args)`

It is WebService::Pixela constructor.

%args might be:

username : Str: Pixela service username.
token : Str: Pixela service token.
base_url : Str : default => 'https://pixe.la/': Pixela service api root url. (It does not include version URL.)
decode : boolean : default => 1: If decode is true it returns a Perl object, false it returns json as is.

What does the WebService::Pixela instance contain?

WebService::Pixela instance have four representative instance methods. Each representative instance methods is an instance of the same class 'WebService::Pixela::' name.

Instance Methods (It does not call other WebService::Pixela::.* instances.)

`$pixela->username : Str`

Output and set the user name of the instance.

`$pixela->token : Str`

Output and set the token of the instance.

`$pixela->base_url : Str`

Output and set the base url of the instance.

`$pixela->decode : boolean`

Output and set the decode of the instance. If decode is true it returns a Perl object, false it returns json as is.

Instance Methods

It conforms to the official API document. See aloso https://docs.pixe.la/ .

`$pixela->user`

This instance method uses a WebService::Pixela::User instance.

`$pixela->user->create(%opts)`

It is Pixe.la user create.

%opts might be:

agree_terms_of_service : [yes|no] (default : "yes" ): Specify yes or no whether you agree to the terms of service. If there is no input, it defaults to yes. (For this module.)
not_minor : [yes|no] (default : "yes"): Specify yes or no as to whether you are not a minor or if you are a minor and you have the parental consent of using this (Pixela) service. If there is no input, it defaults to yes. (For this module.)

`$pixela->user->update($newtoken)`

Updates the authentication token for the specified user.

$newtoken might be:

$newtoken :Str: It is a new authentication token.

`$pixela->user->delete()`

Deletes the specified registered user.

`$pixela->graph`

This instance method uses a WebService::Pixela::Graph instance.

`$pixela->graph->create(%opts) :$hash_ref`

It is Pixe.la graph create.

%opts might be:

[required (autoset)] id : Str

It is an ID for identifying the pixelation graph.

If set in an instance of WebService::Pixela::Graph, use that value.

[required] name : Str

It is the name of the pixelation graph.

[required] unit : Str

It is a unit of the quantity recorded in the pixelation graph. Ex. commit, kilogram, calory.

[required] type : Str

It is the type of quantity to be handled in the graph. Only int or float are supported.

[required] color : Str

Defines the display color of the pixel in the pixelation graph. shibafu (green), momiji (red), sora (blue), ichou (yellow), ajisai (purple) and kuro (black) are supported as color kind.

timezone : Str

[optional] Specify the timezone for handling this graph as Asia/Tokyo. If not specified, it is treated as UTC.

self_sufficient : Str

[optional] If SVG graph with this field increment or decrement is referenced, Pixel of this graph itself will be incremented or decremented. It is suitable when you want to record the PVs on a web page or site simultaneously. The specification of increment or decrement is the same as Increment a Pixel and Decrement a Pixel with webhook. If not specified, it is treated as none .

`$pixela->graph->get()`

Get all predefined pixelation graph definitions.

If you setting $pixela-decode(1) [default]> return array refs. Otherwise it returns json.

`$pixela->graph->get_svg(%args)`

%opts might be:

data :Str: [optional] If you specify it in yyyyMMdd format, will create a pixelation graph dating back to the past with that day as the start date. If this parameter is not specified, the current date and time will be the start date. (it is used <timezone> setting if Graph’s <timezone> is specified, if not specified, calculates it in <UTC>)
mode :Str: [optional] Specify the graph display mode. As of October 23, 2018, support only short mode for displaying only about 90 days.

`$pixela->graph->update(%args)`

%options might be $pixela->graph->create() options.

`$pixela->graph->delete()`

Delete the predefined pixelation graph definition.

`$pixela->graph->html(%args)`

Displays the details of the graph in html format. (This method return html urls)

%args might be

[required (autoset)] id : Str

It is an ID for identifying the pixelation graph.

If set in an instance of WebService::Pixela::Graph, use that value.

( line => true )

[optional] URI tail add line mode parameter.

`$pixela->graph->pixels(%args)`

Get a Date list of Pixel registered in the graph specified by graphID. You can specify a period with from and to parameters.

%args might be

from :Str: [optional] Specify the start position of the period.
to : Str: [optional] Specify the end position of the period.

`$pixela->graph->stats($id)`

Based on the registered information, get various statistics.

$id might be

[required (autoset)] id : Str

It is an ID for identifying the pixelation graph.

If set in an instance of WebService::Pixela::Graph, use that value.

`$pixela->pixel`

This instance method uses a WebService::Pixela::Pixel instance.

`$pixela->pixel->post(%opts)`

It records the quantity of the specified date as a "Pixel".

%opts might be:

([required]) id : Str: Specify the target graph as an ID. If the graph id is set for an instance, it will be automatically used. (You do not need to enter it as an argument)
[required] date : [yyyyMMdd]: The date on which the quantity is to be recorded. It is specified in yyyyMMdd format.
[required] quantity : String: Specify the quantity to be registered on the specified date. Validation rule: int^-?[0-9]+ float^-?[0-9]+.[0-9]+
optional_data : json_string: Additional information other than quantity. It is specified as JSON string. The amount of this data must be less than 10 KB.

See also

https://docs.pixe.la/#/post-pixel

`$pixela->pixel->get(%opts)`

Get registered quantity as "Pixel".

%opts might be:

([required]) id : Str: Specify the target graph as an ID. If the graph id is set for an instance, it will be automatically used. (You do not need to enter it as an argument)
[required] date : [yyyyMMdd]: The date on which the quantity is to be recorded. It is specified in yyyyMMdd format.

See also

https://docs.pixe.la/#/get-pixel

`$pixela->pixel->update(%opts)`

Update the quantity already registered as a "Pixel". If target "Pixel" not exist, create a new "Pixel" and set quantity.

%opts might be:

([required]) id : Str: Specify the target graph as an ID. If the graph id is set for an instance, it will be automatically used. (You do not need to enter it as an argument)
[required] date : [yyyyMMdd]: The date on which the quantity is to be recorded. It is specified in yyyyMMdd format.
quantity : String: Specify the quantity to be registered on the specified date. Validation rule: int^-?[0-9]+ float^-?[0-9]+.[0-9]+
optional_data : json_string: Additional information other than quantity. It is specified as JSON string. The amount of this data must be less than 10 KB.

See also

https://docs.pixe.la/#/put-pixel

`$pixela->pixel->increment(%opts)`

Increment quantity "Pixel" of the day (it is used "timezone" setting if Graph's "timezone" is specified, if not specified, calculates it in "UTC"). If the graph type is int then 1 added, and for float then 0.01 added.

%opts might be:

([required]) id : Str: Specify the target graph as an ID. If the graph id is set for an instance, it will be automatically used. (You do not need to enter it as an argument)
[required] date : [yyyyMMdd]: The date on which the quantity is to be recorded. It is specified in yyyyMMdd format.
length : Int (default 0): Since the request body is not specifield, specify the Content-Length header. (Default 0)

See also

https://docs.pixe.la/#/increment-pixel

`$pixela->pixel->decrement(%opts)`

Decrement quantity "Pixel" of the day (it is used "timezone" setting if Graph's "timezone" is specified, if not specified, calculates it in "UTC"). If the graph type is int then -1 added, and for float then -0.01 added.

%opts might be:

([required]) id : Str: Specify the target graph as an ID. If the graph id is set for an instance, it will be automatically used. (You do not need to enter it as an argument)
[required] date : [yyyyMMdd]: The date on which the quantity is to be recorded. It is specified in yyyyMMdd format.
length : Int (default 0): Since the request body is not specifield, specify the Content-Length header. (Default 0)

See also

https://docs.pixe.la/#/decrement-pixel

`$pixela->pixel->delete(%opts)`

Delete the registered "Pixel".

%opts might be:

([required]) id : Str: Specify the target graph as an ID. If the graph id is set for an instance, it will be automatically used. (You do not need to enter it as an argument)
[required] date : [yyyyMMdd]: The date on which the quantity is to be recorded. It is specified in yyyyMMdd format.

See also

https://docs.pixe.la/#/delete-pixel

`$pixela->webhook`

This instance method uses a WebService::Pixela::Webhook instance.

`$pixela->webhook->create(%opts)`

Create a new Webhook by Pixe.la This method return webhookHash, this is automatically set instance.

%opts might be:

[required] graph_id : Str: Specify the target graph as an ID. If the graph id is set for an instance, it will be automatically used. (You do not need to enter it as an argument)
[required] type : [increment|decrement]: Specify the behavior when this Webhook is invoked. Only increment or decrement are supported. (There is no distinction between upper case and lower case letters.)

`$pixela->webhook->hash($webhookhash)`

This is webhookHash. Used by Pixela's webhook service.

$webhookhash might be:

$webhookhash :Str: It is a new webhookHash. If the graph id is set for an instance, it will be automatically used create method.

`$pixela->webhook->get()`

Get all predefined webhooks definitions. This method return array_ref or json value(switching decode method).

`$pixela->webhook->invoke($webhookhash)`

Invoke the webhook registered in advance. It is used “timezone” setting as post date if Graph’s “timezone” is specified, if not specified, calculates it in “UTC”.

$webhookhash might be:

$webhookhash :Str: If the webhookhash is using thid method , it will be automatically used. (You do not need to enter it as an argument)

`$pixela->webhook->delete($webhookhash)`

Delete the registered Webhook.

$webhookhash might be:

$webhookhash :Str: If the webhookhash is using thid method , it will be automatically used. (You do not need to enter it as an argument)

LICENSE

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

AUTHOR

Takahiro SHIMIZU <anatofuz@gmail.com>

To install WebService::Pixela, copy and paste the appropriate command in to your terminal.

cpanm

cpanm WebService::Pixela

CPAN shell

perl -MCPAN -e shell
install WebService::Pixela

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)

NAME

SYNOPSIS

DESCRIPTION

CI_PIXELA

ORIGINAL API DOCUMENT

INTERFACE

Class Methods

WebService::Pixela->new(%args)

What does the WebService::Pixela instance contain?

Instance Methods (It does not call other WebService::Pixela::.* instances.)

$pixela->username : Str

$pixela->token : Str

$pixela->base_url : Str

$pixela->decode : boolean

Instance Methods

$pixela->user

$pixela->user->create(%opts)

$pixela->user->update($newtoken)

$pixela->user->delete()

$pixela->graph

$pixela->graph->create(%opts) :$hash_ref

$pixela->graph->get()

$pixela->graph->get_svg(%args)

$pixela->graph->update(%args)

$pixela->graph->delete()

$pixela->graph->html(%args)

$pixela->graph->pixels(%args)

$pixela->graph->stats($id)

$pixela->pixel

$pixela->pixel->post(%opts)

$pixela->pixel->get(%opts)

$pixela->pixel->update(%opts)

$pixela->pixel->increment(%opts)

$pixela->pixel->decrement(%opts)

$pixela->pixel->delete(%opts)

$pixela->webhook

$pixela->webhook->create(%opts)

See also

$pixela->webhook->hash($webhookhash)

$pixela->webhook->get()

$pixela->webhook->invoke($webhookhash)

$pixela->webhook->delete($webhookhash)

LICENSE

AUTHOR

Module Install Instructions

`WebService::Pixela->new(%args)`

`$pixela->username : Str`

`$pixela->token : Str`

`$pixela->base_url : Str`

`$pixela->decode : boolean`

`$pixela->user`

`$pixela->user->create(%opts)`

`$pixela->user->update($newtoken)`

`$pixela->user->delete()`

`$pixela->graph`

`$pixela->graph->create(%opts) :$hash_ref`

`$pixela->graph->get()`

`$pixela->graph->get_svg(%args)`

`$pixela->graph->update(%args)`

`$pixela->graph->delete()`

`$pixela->graph->html(%args)`

`$pixela->graph->pixels(%args)`

`$pixela->graph->stats($id)`

`$pixela->pixel`

`$pixela->pixel->post(%opts)`

`$pixela->pixel->get(%opts)`

`$pixela->pixel->update(%opts)`

`$pixela->pixel->increment(%opts)`

`$pixela->pixel->decrement(%opts)`

`$pixela->pixel->delete(%opts)`

`$pixela->webhook`

`$pixela->webhook->create(%opts)`

`$pixela->webhook->hash($webhookhash)`

`$pixela->webhook->get()`

`$pixela->webhook->invoke($webhookhash)`

`$pixela->webhook->delete($webhookhash)`