The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

WWW::Authy - Easy access to the already so easy Authy API

VERSION

version 0.002

SYNOPSIS

  my $authy = WWW::Authy->new($authy_api_key);

  # email, cellphone, country code (optional)
  my $id = $authy->new_user('email@universe.org','555-123-2345','1');

  $authy->verify($id,$token) or print (Dumper $authy->errors);

  $authy->sms($id); # send sms for token

DESCRIPTION

This library gives an easy way to access the API of Authy 2-factor authentification system.

ATTRIBUTES

api_key

API Key for the account given on the Account Settings

sandbox

Use the sandbox instead of the live system. This is off by default.

error

Gives back the error of the last request, if any given.

base_uri

Base of the URL of the Authy API, this is https://api.authy.com without sandbox mode, and http://sandbox-api.authy.com, when the sandbox is activated.

useragent

LWP::UserAgent object used for the HTTP requests.

useragent_agent

The user agent string used for the "useragent" object.

useragent_timeout

The timeout value in seconds used for the "useragent" object, defaults to default value of LWP::UserAgent.

json

JSON object used for JSON decoding.

METHODS

new_user

Takes the email, the cellphone number and optional the country code as parameters and gives back the id for this user. Authy will generate the user if he doesn't exist (verified by cellphone number), on a matching entry it just gives back the existing user id.

verify

Verifies the first parameter as user id against the second parameter the token. It gives back a true or a false value, it still could be another error then an invalid token, so far this module doesnt differ.

sms

Send a SMS to the given user id. Please be aware that this may produce cost. See the pricing on http://www.authy.com/pricing/ for more informations.

SUPPORT

IRC

  Join #duckduckgo on irc.freenode.net. Highlight Getty for fast reaction :).

Repository

  http://github.com/Getty/p5-www-authy
  Pull request and additional contributors are welcome

Issue Tracker

  http://github.com/Getty/p5-www-authy/issues

AUTHOR

Torsten Raudssus <torsten@raudss.us>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Torsten Raudssus.

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