C/2/proxy/badges/badge
badges/badge
获取某个用户所获得的勋章列表。
URL
https://c.api.weibo.com/2/badges/badge.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
请求所有商业接口:
- 50000次/小时/IP;
- 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表示不回收;
其他
无
文档更新时间: 2016-08-02