NAME

Net::Sendy::API - Perl SDK to sendy.co

SYNOPSIS

    use Net::Sendy::API;
    my $sendy = Net::Sendy::API->new(
        api_key => $api_key,
        url     => 'http://www.example.com/sendy/'
    );

    my $r = $sendy->subscribe(email => 'example@example.com', list => 'e');

    unless ( $r->is_success ) {
        die "HTTP request failed" > $r->status_line;
    }

ABSTRACT

Perl extension to interact with a sendy.co instance.

DESCRIPTION

This is an interface to http://www.sendy.co/api. As of this writing this is the complete implementation of the Sendy API.

METHODS

new(api_key => $key, url => $url);

All the arguments are required. api_key is what you receive in the email, after purchasing Sendy. url is the URL to the folder where sendy is installed.

Returns a class instance. It not expected to fail.

subscribe(list => $list_id, email=>$email)

subscribe(list => $list_id, email => $email, custom_name => $custom_value,....)

Subscribes an e-mail address to a list, where list is identified by its, what is called, an encrypted id. You can find this id next to each list name in the listing

If your list has custom fields you can enter them by passing more key/value pairs to the method.

Returns an instance of HTTP::Response. Example

    my $r = $sendy->subscribe(list => 'b', email => 'sherzodr@cpan.org', birth_day => "2013-09-12");
    unless ( $r->is_success ) {
        die "HTTP request failed: " . $r->status_line;
    }
    my $message = $r->decoded_content;

$message, according to http://www.sendy.co/api, can be 1, Some fields are missing., Invalid email address., Invalid list ID., Already subscribed..

unsubscribe(list => $list_id, email => $email)

All the arguments are required. Unsubscribe an e-mail address from a list. See subscribe() for the definition of the arguments. Returns an instance of HTTP::Response. Example:

    my $r = $sendy->unsubscribe(list => 'b', email => 'sherzodr@example.com');
    unless ( $r->is_success ) {
        die "HTTP request failed: " . $r->status_line;
    }
    my $message = $r->decoded_content;

$message, according to http://www.sendy.co/api, can be 1, Some fields are missing., Invalid email address.

subscription_status(list => $list_id, email => $email)

Returns an instance of HTTP::Response. Body of the response can contain Subscribed, Unsubscribed, Unconfirmed, Bounced, Soft bounced, Complained, No data passed, API key not passed, Invalid API key, Email not passed, List ID not passed, Email does not exist in list.

For details on getting the body of the response see above.

active_subscriber_cont(list=>$list_id)

Returns an instance of HTTP::Response. Body of the response should contain an integer if the call succeeds. If not, it may contains No data passed, API key not passed, Invalid API key, List ID not passed, List does not exist.

For details on getting the body of the response see above.

SEE ALSO

LWP::UserAgent, HTTP::Response, http://www.sendy.co/api.

AUTHOR

Sherzod B. Ruzmetov <sherzodr@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2013 by Talibro LLC.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.14.2 or, at your option, any later version of Perl 5 you may have available.