Sha256: 32041c67b3112b151275440235f49cc0bc9a0a8baa37230298246631a7c3e833

Contents?: true

Size: 1.96 KB

Versions: 7

Compression:

Stored size: 1.96 KB

Contents

= Vkontakte

The easiest way to access Vkontakte API and some other utils.
More info about API:

1. http://vk.com/developers.php?oid=-1&p=%D0%90%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F

2. http://vk.com/developers.php?oid=-1&p=%D0%92%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5_%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2_%D0%BA_API

3. http://vk.com/developers.php?oid=-1&p=%D0%9F%D1%80%D0%B0%D0%B2%D0%B0_%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%B0_%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D0%B9

== Install

  gem 'vkontakte'

== Configure

  Vkontakte.setup do |config|
    config.app_id = "YOUR Vkontakte API ID"
    config.app_secret = "YOUR Vkontakte APP SECRET"
    config.format = :json
    config.debug = false
    config.logger = File.open(Rails.root.join('log', 'vkontakte.log'), "a")
  end

== Usage

=== User API by access_token

  user = Vkontakte::App::User.new(uid, :access_token => ACCESS_TOKEN)
  user.fetch # {"response"=>[{"uid"=>2592709, ...

Profile

  user.profile.isAppUser      # {"response"=>"1"}
  user.profile.getUserBalance
  user.profile.getUserSettings
  user.profile.likesGetList(:type => 'post')

Photos

  user.photos.getAlbums
  user.photos.getAlbumsCount
  user.photos.get(:aid => 'album_id')

Groups

  user.groups.get
  user.groups.isMember(:gid => 'group_id')
  user.groups.join(:gid => 1)
  user.groups.leave(:gid => 1)

Friends

  user.friends.get
  user.friends.getOnline

=== Secure API

  @app = Vkontakte::App::Secure.new
  @app.secure.getAppBalance         # {"response"=>2000}
  @app.auth                         # {"expires_in"=>0, "access_token"=>"d173f5...319f"}

=== IFrame application

Check if auth_key is valid:

  def index
    @app = Vkontakte::App::Iframe.new
    @app.params = params

    if @app.valid_auth_key?
      session[:viewer_id] = params[:viewer_id]
    else
      render :action => "failure"
    end
  end

== Test

  rake spec

Copyright (c) 2011 Aimbulance, released under the MIT license

Version data entries

7 entries across 7 versions & 1 rubygems

Version Path
vkontakte-0.0.9 README.rdoc
vkontakte-0.0.8 README.rdoc
vkontakte-0.0.7 README.rdoc
vkontakte-0.0.6 README.rdoc
vkontakte-0.0.5 README.rdoc
vkontakte-0.0.4 README.rdoc
vkontakte-0.0.3 README.rdoc