NAME

NAME

WebService::Pingboard

DESCRIPTION

Interaction with Pingboard

This module uses MooseX::Log::Log4perl for logging - be sure to
initialize!

ATTRIBUTES

cache

Optional.

Provided by MooseX::WithX - optionally pass a Cache::FileCache object
to cache and avoid unnecessary requests

refresh_token

password

username

client_id

client_secret

credentials_file

timeout

Timeout when communicating with Pingboard in seconds. Optional.
Default: 10 Will only be in effect if you allow the useragent to be
built in this module.

default_backoff

Optional. Default: 10 Time in seconds to back off before retrying
request. If a 429 response is given and the Retry-Time header is
provided by the api this will be overridden.

default_page_size

Optional. Default: 100

retry_on_status

Optional. Default: [ 429, 500, 502, 503, 504 ] Which http response
codes should we retry on?

max_tries

Optional. Default: undef

Limit maximum number of times a query should be attempted before
failing. If undefined then unlimited retries

api_url

Default: https://app.pingboard.com/api/v2/

user_agent

Optional. A new LWP::UserAgent will be created for you if you don't
already have one you'd like to reuse.

loglevel

Optionally override the global loglevel for this module

METHODS

valid_access_token

Will return a valid access token.

access_token_is_valid

Returns true if a valid access token exists (with at least 5 seconds
validity remaining).

headers

Returns a HTTP::Headers object with the Authorization header set with
a valid access token

API METHODS

This is a module in development - only a subset of all of the API
endpoints have been implemented yet. The full documentation is
available here: http://docs.pingboard.apiary.io/#

Generic parameters

Any of the methods below which return paged content accept the
parameters:

limit

Optional. Maximum number of entries to fetch.

page_size

Optional. Page size to use when fetching.

options

Optional. Additional url options to add

get_users

Retrieve a list of users

Details:
http://docs.pingboard.apiary.io/#reference/users/users-collection/get
-users

get_groups

Get list of user groups

Details:
http://docs.pingboard.apiary.io/#reference/groups/groups-collection/g
et-groups

get_custom_fields

Get list of custom fields

Details:
http://docs.pingboard.apiary.io/#reference/custom-fields/custom-field
s-collection/get-custom-fields

get_linked_accounts

Get linked accounts

Details:
http://docs.pingboard.apiary.io/#reference/linked-accounts/linked-acc
ount/get-linked-account

get_linked_account_providers

Get linked account providers

Details:
http://docs.pingboard.apiary.io/#reference/linked-account-providers/l
inked-account-providers-collection/get-linked-account-providers

get_status_types

Get status types

Details:
http://docs.pingboard.apiary.io/#reference/status-types/status-types-
collection/get-status-types

get_statuses

Get statuses

Details:
http://docs.pingboard.apiary.io/#reference/statuses/status/update-sta
tus

update_status

Update a Status resource.

Details:
http://docs.pingboard.apiary.io/#reference/statuses/status/get-status

status

HashRef object of the status - only fields being changed must be
defined

delete_status

delete a Status resource.

Details:
http://docs.pingboard.apiary.io/#reference/statuses/status/delete-sta
tus

create_status

Create a new Status resource.

Details:
http://docs.pingboard.apiary.io/#reference/statuses/statuses-collecti
on/create-status

status

HashRef of the new status

clear_cache_object_id

Clears an object from the cache.

object_id

Required. Object id to clear from the cache.

Returns whether cache_del was successful or not

COPYRIGHT

Copyright 2015, Robin Clarke

AUTHOR

Robin Clarke <[email protected]>

Jeremy Falling <[email protected]>