Skip to content

users.recommendation

lisztli edited this page Feb 8, 2012 · 2 revisions

#GET /2/users/recommendation [Ver 2.0]

返回系统推荐的好友

##路径

http://api.fanfou.com/2/users/recommendation.[json|xml|rss]

##调用方法

GET

##限制条件

用户登录

##参数:

###count

  • 作用:指定一次请求返回的用户数量,默认值为20

  • 格式: count=20

  • 字段说明:可选

###page

  • 作用: 此api每次返回20个推荐用户, page用于指定返回结果的页码

  • 格式: page=page_id

  • 字段说明: 可选

###mode

  • 作用: 当mode=default(默认)时,返回消息中用户信息包含用户自定义profile.mode=lite, profile不会包含在返回信息中

  • 格式: mode=[default|lite]

  • 字段说明: 可选

###format

  • 作用: 当format=html时,返回消息中@提到的用户,网址等输出html链接

  • 格式: format=html

  • 字段说明: 可选

###callback

  • 作用: 当使用json格式时,生成的json对象将作为参数传给指定的javascript函数

  • 格式: callback=javascript函数名

  • 字段说明: 可选

##返回结果

###成功

  • HTTP Status Code

    200 OK HTTP/1.1

  • 返回值

    • json格式

      返回一个由用户的详细信息组成的数组,用户的详细信息格式参见users.show

        [
            user_0,
            user_1,
            ...
        ]
      
Clone this wiki locally