NAME

WebService::Futu - Perl interface to the Futu API

VERSION

Version 0.01

SYNOPSIS

 use WebService::Futu;
 
 my $ws = WebService::Futu->new(     user => 'username',
                                     pass => 'password'    );

 my $body = $ws->perform_get('/api/personal');

 my $trans = {
        date => {
                day => 12,
                month => 10,
                year => 2010
        },
        amount => 100,
        tags => {
                dir => 'out',
                how => 'platba v hotovosti',
                regularity => "b\x{11b}\x{17e}n\x{e1}",
                what => "Jidlo",
                whom => "Tesco",
                who => "",
                product => "cash",
                card => ""
        },
        note => 'Something to eat.'
 };

 $ws->perform_post('/api/transaction/', $trans));

DESCRIPTION

Library for comuniccation with Futu API.

METHODS

new( [user => $username|id => $futuid], pass => $password, url => $url )

Call new() to create a new Futu object. You have to pass username or futu id and password.

It is possible to pass base url for API queries with parameter url. (default 'http://www.futu.cz')

Example:

 my $bc = WebService::Futu->new( user => $username, 
                                     pass => $password );

error()

Returns any error messages as a string.

perform_get()

Perform request on the server. Automatically request authentication token.

 my $personal = $self->perform_get('/api/personal');
 

perform_post($content)

Perform post on the server. Automatically request authentication token. $content is used for sending content.

 my $personal = $self->perform_post('/api/transaction/', $content);
 

perform_put($content)

Perform put on the server. Automatically request authentication token. $content is used for sending content.

 my $personal = $self->perform_put('/api/transaction/123', $content);
 

perform_delete($content)

Perform delete on the server. Automatically request authentication token. $content is used for sending content.

 my $personal = $self->perform_delete('/api/transaction/123', $content);
 

AUTHOR

Vaclav Dovrtel, <vaclav.dovrtel at gmail.com>

BUGS

Please report any bugs or feature requests to bug-webservice-futu at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WebService-Futu. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc WebService::Futu

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=WebService-Futu

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/WebService-Futu

• CPAN Ratings

  http://cpanratings.perl.org/d/WebService-Futu

• Search CPAN

  http://search.cpan.org/dist/WebService-Futu/

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2010 Vaclav Dovrtel.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.