C/2/proxy/badges/badge

跳转到: 导航, 搜索

badges/badge

获取某个用户所获得的勋章列表。

URL

https://c.api.weibo.com/2/badges/badge.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录


关于登录授权,参见 如何登录授权

访问授权限制


请求所有商业接口:

    • 50000次/小时/IP;

请求参数

  必选 类型及范围 说明
source false string 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。
access_token false string 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。
uid true int64 需要查询的用户UID。
page false int 返回结果的页码,默认为1。
count false int 返回结果的条数数量,最大不超过200,默认为20。
is_show false int 是否只返回用户设置为在首页展示的勋章,0:否(全部勋章),1:是(仅返回设为首页展示的勋章),默认为0。
lang false string 返回的语言设置,zh-cn:简体中文,zh-tw:繁体中文,默认为zh-cn。

注意事项

  • 参数uid不填,则查看当前登录用户自己;

返回结果

JSON示例

//成功返回
[
    {
        "id": "14",
        "name": "应用牛人",
        "small_icon": "http://img.t.sinajs.cn/t4/style/images/medal/14_s.gif",
        "icon_white": "http://img.t.sinajs.cn/t4/style/images/medal/14_m.png",
        "icon_transparent": "http://img.t.sinajs.cn/t4/style/images/medal/14_l.png",
        "created_at": "2010.12.16"
    }
]

//失败返回
{
    "request": "/2/proxy/badges/badge.json",
    "error_code": "218XX",
    "error": "error message."
}

关于错误返回值与错误代码,参见 错误代码说明

字段说明

  • id:勋章ID;
  • name_cn:简体勋章名称;
  • small_icon:勋章小图标URL;
  • icon_white:白色背景勋章大图标URL;
  • icon_transparent:透明背景勋章大图标URL;
  • created_at:勋章创建(授予)时间;
  • description:简体版描述;
  • task:获得勋章所需任务;
  • task_link:完成任务的地址;
  • start_time:勋章开始发行的时间;
  • end_time:勋章停止发行的时间;
  • circulation:发行量;
  • expire_time:勋章回收时间,为0表示不回收;

其他



Language: [[{{{2/uri}}}|中文]]


api评价