Class: Renren2::Interface::Friends

Inherits:
Base
  • Object
show all
Defined in:
lib/renren2/interface/friends.rb

Overview

Friends Interface

See Also:

Instance Method Summary collapse

Methods inherited from Base

#check_scope, #initialize, #post, #request

Constructor Details

This class inherits a constructor from Renren2::Interface::Base

Instance Method Details

#are_friends(uids1, uids2) ⇒ Object

判断两组用户是否互为好友关系，比较的两组用户数必须相等

Parameters:

  • uids1 (String) —

    第一组用户的ID，每个ID之间以逗号分隔

  • uids2 (String) —

    第二组用户的ID，每个ID之间以逗号分隔

See Also:



17
18
19
 
# File 'lib/renren2/interface/friends.rb', line 17

def are_friends(uids1, uids2)
  post 'friends.areFriends', :body => {:uids1 => uids1, :uids2 => uids2}
end

#get ⇒ Object

得到当前登录用户的好友列表，得到的只是含有好友uid的列表

Parameters:

  • opts (Hash)

See Also:



28
29
30
 
# File 'lib/renren2/interface/friends.rb', line 28

def get
  post 'friends.get'
end

#get_app_friends(opts = {}) ⇒ Object

返回App好友的ID列表

Parameters:

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :fields (String) —

    返回的字段列表，可以指定返回那些字段，用逗号分隔。 目前支持name（姓名）、tinyurl(小头像)、headurl（中等头像），如果不传递此参数，默认返回好友id节点

See Also:



70
71
72
 
# File 'lib/renren2/interface/friends.rb', line 70

def get_app_friends(opts={})
  post 'friends.getAppFriends', :body => opts
end

#get_app_users ⇒ Object

返回已经添加了一个应用的好友的用户Id列表，此接口只返回全部好友中的数据

See Also:



59
60
61
 
# File 'lib/renren2/interface/friends.rb', line 59

def get_app_users
  post 'friends.getAppUsers'
end

#get_friends(opts = {}) ⇒ Object

得到当前登录用户的好友列表

Parameters:

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :page (int) —

    分页，默认为1

  • :count (int) —

    返回每页个数，默认为500

  • :fields (String) —

    需要返回的字段，多个字段用逗号(,)隔开。目前支持如下字段: headurl_with_logo, tinyurl_with_logo

See Also:



52
53
54
 
# File 'lib/renren2/interface/friends.rb', line 52

def get_friends(opts={})
  post 'friends.getFriends', :body => opts
end

#get_same_friends(uid1, uid2, opts = {}) ⇒ Object

获取两个用户的共同好友

Parameters:

  • uid1 (int) —

    用户1

  • uid2 (int) —

    用户2

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :fields (String) —

    好友属性列表（逗号分隔）。支持的值有：uid,name,sex,tinyurl,headurl,mainurl。 缺省：uid

See Also:



40
41
42
 
# File 'lib/renren2/interface/friends.rb', line 40

def get_same_friends(uid1, uid2, opts={})
  post 'friends.getSameFriends', :body => {:uid1 => uid1, :uid2 => uid2}.merge(opts)
end

#search(name, opts = {}) ⇒ Object

搜索用户，根据搜索条件返回搜索结果

Parameters:

  • name (String) —

    搜索姓名

  • opts (Hash) (defaults to: {})

Options Hash (opts):

  • :condition (String) —

    查询条件。 json格式如： “t”搜索条件类型，各个类型包含的条件如下：

    1. "t":"base" 基本信息，"gend" 性别，"prov" 省份，"city" 城市
2. "t":"univ" 大学，   "name" 大学名称，"id" 大学的id见主站，"depa" 学院，"year" 入学年份
3. "t":"high" 高中，   "name" 高中名称，"year" 入学年份
4. "t":"sect" 中专技校，"name" 名称，   "year" 入学年份
5. "t":"juni" 初中，   "name" 初中名称，"year" 入学年份
6. "t":"elem" 小学，   "name" 小学称，  "year" 入学年份
7. "t":"birt" 生日，   "year" 年，     "month" 月， "day" 日， "astr" 星座
8. "t":"work" 公司，   "name" 公司名称
  • :page (int) —

    分页显示的页码 缺省值为1

  • :count (int) —

    每页显示的日志的数量, 缺省值为20

See Also:



93
94
95
 
# File 'lib/renren2/interface/friends.rb', line 93

def search(name, opts={})
  post 'friends.search', :body => {:name => name}.merge(opts)
end