The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Google::reCAPTCHA - A simple lightweight implementation of Google's reCAPTCHA for perl

SYNOPSIS

    use Google::reCAPTCHA;

    my $c = Google::reCAPTCHA->new( secret => 'secret_key' );
    
    # Verifying the user's response 
    my $response = $c->siteverify( response => 'response_key', remoteip => '192.168.0.1' );

GETTING STARTED

To use reCAPTCHA you need to register your site here:

https://www.google.com/recaptcha/admin/create

PUBLIC INTERFACE

Google::reCAPTCHA->new( secret => 'secret_key' )

Our constructor, will croak when invalid parameters are given.

secret

Required. The shared key between your site and ReCAPTCHA.

siteverify( response => 'response_key', remoteip => '192.168.0.1' )

Request siteverify from Google reCAPTCHA API

response

Required. Form data containing g_captcha_response.

remoteip

Optional. User's ip address.

Errors

Error code reference:

missing-input-secret The secret parameter is missing. invalid-input-secret The secret parameter is invalid or malformed. missing-input-response The response parameter is missing. invalid-input-response The response parameter is invalid or malformed.

Git repo

https://bitbucket.org/tcorkran/google-recaptcha

VERSION

0.01

AUTHOR

Thomas Corkran <thomas.corkran@endurance.com>

CONTRIBUTORS

Christopher Mevissen <mev412@gmail.com>

ACKNOWLEDGEMENTS

Matthew Green <green.matt.na@gmail.com>

This projects work was sponsored by Hostgator.com. http://www.hostgator.com http://www.endurance.com

COPYRIGHT & LICENSE

Copyright 2015, Thomas Corkran <thomascorkran@gmail.com>

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