NAME
Net::Dropbox::API - A dropbox API interface
VERSION
Version 1.2.1
SYNOPSIS
The Dropbox API is a OAuth based API. I try to abstract as much away as possible so you should not need to know too much about it. This is how it works:
use Net::Dropbox::API;
my $box = Net::Dropbox::API->new({key => 'KEY', secret => 'SECRET'});
my $login_link = $box->login; # user needs to klick this link and login
$box->auth; # oauth keys get exchanged
my $info = $box->account_info; # and here we have our account infoSee the examples for a working Mojolicious web client using the Dropbox API.
FUNCTIONS
login
This sets up the initial OAuth handshake and returns the login URL. This URL has to be clicked by the user and the the user then has to accept the application in dropbox.
Dropbox then redirects back to the callback URL defined with $self->callback_url. If the user already accepted the application the redirect may happen without the user actually clicking anywhere.
auth
The auth method changes the initial request token into access token that we need for subsequent access to the API. This method only has to be called once after login.
account_info
account_info polls the users info from dropbox.
list
lists all files in the path defined.
copy
copies a folder copy($from, $to)
move
move a folder move($from, $to)
mkdir
creates a folder mkdir($path)
delete
delete a folder delete($path)
view
creates a cookie protected link for the user to look at. view($path)
metadata
creates a cookie protected link for the user to look at. metadata($path)
putfile
uploads a file to dropbox
getfile
get a file from dropbox
INTERNAL API
_talk
_talk handles the access to the restricted resources. You should normally not need to access this directly.
nonce
Generate a different nonce for every request.
talk
AUTHOR
Lenz Gschwendtner, <norbu09 at cpan.org>
With Bug fixes from:
Greg Knauss gknauss at eod.com
Chris Prather chris at prather.org
Shinichiro Aska
BUGS
Please report any bugs or feature requests to bug-net-dropbox-api at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-Dropbox-API. 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 Net::Dropbox::APIYou can also look for information at:
RT: CPAN's request tracker
AnnoCPAN: Annotated CPAN documentation
CPAN Ratings
Search CPAN
COPYRIGHT & LICENSE
Copyright 2010 Lenz Gschwendtner.
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.