user/favs/wiki 用户收藏的条目

获取用户收藏的条目。这个用户可以是当前登录用户,也可以是由参数指定的用户。

URL

支持格式

  • JSON
  • XML

HTTP请求方式

GET

认证方式

  • API Key 认证
  • OAuth 认证

若进行OAuth登录,则返回当前登录用户的信息,否则将根据 uid 或 user_name 返回对应用户信息。

请求参数

必填 类型
uid false int 用户uid。
user_name false string 用户名。
obj_type false string 限定被收藏条目的类型,多个类型以半角逗号隔开。如 obj_type=music,radio
fav_type false string 限定收藏类型,多个类型以半角逗号隔开。如 fav_type=1,2
page false int 当前结果页码,默认为1。
perpage false int 每页返回的收藏记录数,默认为20,取值范围为[1, 100]。

注意事项

  • uid 与 user_name 作为参数时,二者只能选其一;其中 uid 优先。
  • 若不带参数,则默认返回当前OAuth登录用户的信息。

返回结果

JSON示例

{
   "response":{
      "infomation":{
         "parameters":{
            "uid":"1"
         },
         "msg":[ ],
         "has_error":false,
         "request":"\/user\/favs\/wiki.xml?uid=1"
      },
      "favs_infomation":{
         "page":1, // 当前页数
         "perpage":20, // 每页数量
         "count":36 // 收藏总数
      },
      "favs":[ // 收藏记录
         {
            "fav_id":1237,
            "fav_obj_id":1198,
            "fav_obj_type":"radio",
            "fav_uid":1,
            "fav_date":1321778165,
            "fav_type":1,
            "obj":object // 被收藏的对象,因为为'radio'故此处为条目对象
         },
         {
            "fav_id":1232,
            "fav_obj_id":1174,
            "fav_obj_type":"music",
            "fav_uid":1,
            "fav_date":1320075525,
            "fav_type":1,
            "obj":object
         },
         ......
      ]
   }
}
api/user/favs/wiki.txt · 最后更改: 2015-01-09 22:32 (外部编辑)