VK::App - Creation of a client application for vk.com
### Application object creation ### #1. Authorizing by login and password use VK::App; my $vk = VK::App->new( # Your email or mobile phone to vk.com login => 'login', # Your password to vk.com password => 'password', # The api_id of application api_id => 'api_id', # Name of the file to restore cookies from and save cookies to #(this parameter is optional in this case) cookie_file => '/home/user/.vk.com.cookie', ); #2. Authorizing by cookie file use VK::App; my $vk = VK::App->new( # Name of the file to restore cookies from and save cookies to cookie_file => '/home/user/.vk.com.cookie', # The api_id of application api_id => 'api_id', ); #3. Set additional options use VK::App; my $vk = VK::App->new( # Name of the file to restore cookies from and save cookies to cookie_file => '/home/user/.vk.com.cookie', # The api_id of application api_id => 'api_id', # Set application access rights scope => 'friends,photos,audio,video,wall,groups,messages,offline', # Data format that will receive as a result of requests 'JSON', 'XML' or 'Perl'. # Perl object by default. format => 'Perl', ); ### Requests examples ### #1. Get user id by name my $user = $vk->request('getProfiles',{uid=>'genaev',fields=>'uid'}); my $uid = $user->{response}->[0]->{uid}; #2. Get a list of tracks by uid my $tracks = $vk->request('audio.get',{uid=>$uid}); my $url = $tracks->{response}->[0]->{url}; # get url of the first track
VK::App - Module for creation of client applications based on OAuth 2.0, receiving access rights and sending requests to API vk.com. First, you need to get api_id application that will work with the API of vk.com. You can register your application at http://vk.com/apps.php?act=add or use api_id of the existing application.
This package also includes scripts/vmd.pl script, that shows how to use the module.
new
Creates and returns an VK::App object. Takes a list containing key-value pairs.
Required Arguments
api_id
The api_id of application. You can register your application at http://vk.com/apps.php?act=add or use api_id of the existing application.
login
Your email or mobile phone to vk.com
password
Your password to vk.com
cookie_file
Name of the file to restore cookies from and save cookies to. Notice that instead of a login and password, you can only use the file cookie_file!
Other Important Arguments
scope
Set application access rights. List of available access rights http://vk.com/developers.php?oid=-17680044&p=Application_Access_Rights. 'friends,photos,audio,video,wall,groups,messages,offline' by default.
format
Data format that will receive as a result of requests 'JSON', 'XML' or 'Perl'. Perl object by default.
request
Send requests and return response.
my $response = $vk->request($METHOD_NAME,$PARAMETERS);
API method description available at http://vk.com/developers.php?oid=-17680044&p=API_Method_Description
ua
Returns LWP::UserAgent object. This can be useful for downloading music, videos or photos from vk.com. See scripts/vmd.pl script that is included in the package.
uid
Returns UID of the current user.
access_token
Returns access_token. access_token - access key received as a result of successful application authorization.
You can find documentation for this module with the perldoc command.
perldoc VK::App
If you have any questions or suggestions please contact me by email.
Misha Genaev, <mag at cpan.org> (http://genaev.com/)
Copyright 2012 by Misha Genaev
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install VK::App, copy and paste the appropriate command in to your terminal.
cpanm
cpanm VK::App
CPAN shell
perl -MCPAN -e shell install VK::App
For more information on module installation, please visit the detailed CPAN module installation guide.