package WWW::Shorten::SnipURL;
use 5.006;
use strict;
use warnings;
use base qw( WWW::Shorten::generic Exporter );
our @EXPORT = qw(makeashorterlink makealongerlink);
our $VERSION = "1.81";
use Carp;
use URI;
sub makeashorterlink ($;%)
{
my $url = shift or croak 'No URL passed to makeashorterlink';
my $ua = __PACKAGE__->ua();
my ($nick,$pass) = @_;
my $snipurl = 'http://snipurl.com/teindex.php';
my $resp = $ua->post($snipurl, [
link => $url,
alias => (defined $nick ? $nick : ''),
protected_key => (defined $pass ? $pass : ''),
]);
return unless $resp->is_success;
if ($resp->content =~ m!
]*>
(http://sn(?:ip)?url\.com/\w+)
!xm) {
return $1;
}
return undef;
}
sub makealongerlink ($)
{
my $code = shift
or croak 'No SnipURL key / URL passed to makealongerlink';
my $ua = __PACKAGE__->ua();
$code =~ s{^ http:// .* / }{}x;
my $snipurl_url = URI->new('http://snipurl.com/resolveurl');
$snipurl_url->query_form(
id => $code,
);
my $resp = $ua->get($snipurl_url);
return undef unless $resp->is_success;
my $content = $resp->content;
return undef if $content eq 'ERROR';
my ($link) = $content =~ m! " ([^"]+) " !xi;
return $link;
}
1;
__END__
=head1 NAME
WWW::Shorten::SnipURL - Perl interface to SnipURL.com
=head1 SYNOPSIS
use WWW::Shorten::SnipURL;
use WWW::Shorten 'SnipURL';
$short_url = makeashorterlink($long_url);
$long_url = makealongerlink($short_url);
=head1 DESCRIPTION
A Perl interface to the web service SnipURL.com. SnipURL maintains a
database of long URLs, each of which has a unique identifier or
nickname. For more features, please visit http://snipurl.com/features
The function C will call the SnipURL web site passing it
your long URL and will return the shorter SnipURL version. If used in a
list context, then it will return both the Snip URL and the password.
The function C does the reverse. C
will accept as an argument either the full Snip URL or just the
SnipURL identifier.
If anything goes wrong, then either function will return C.
=head2 EXPORT
makeashorterlink, makealongerlink
=head1 SUPPORT, LICENCE, THANKS and SUCH
See the main L docs.
=head1 AUTHOR
Iain Truskett
=head1 SEE ALSO
L, L, L
=cut