NAME

VK::App - Creation of a client application for vk.com

SYNOPSIS

    ### 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

DESCRIPTION

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.

METHODS

`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 https://vk.com/editapp?act=create 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/dev/permissions. '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/dev/methods

`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.

SUPPORT

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.

AUTHOR

Misha Genaev, <mag at cpan.org> (http://genaev.com/)

COPYRIGHT

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