Badges
(创建新页面为 '{{api_desc2| uri=badges| desc=查看某个用户所获得的勋章列表| format=XML/JSON| httpMethod=GET| needAuth=true| rateLimit=true| params={{api_args|uid|false|string|查…') |
|||
| 第47行： | 第47行： | ||
… | … | ||
] | ] | ||
| − | </pre>| | + | </pre> |
| − | useAge=uid不填，则查看当前登录用户自己； | + | ===字段说明=== |
| + | *badge_id：勋章ID | ||
| + | *name：勋章名称 | ||
| + | *description：勋章描述 | ||
| + | *link：勋章活动页面链接地址URL | ||
| + | *small_icon：勋章小图标URL | ||
| + | *middle_icon：勋章中图标URL | ||
| + | *large_icon：勋章大图标URL | ||
| + | *deadline：勋章截止日期 | ||
| + | *is_show：勋章是否显示 | ||
| + | *created_at：勋章创建（授予）时间| | ||
| + | *useAge=uid不填，则查看当前登录用户自己； | ||
| | | | ||
otherInfo=无 | otherInfo=无 | ||
}} | }} | ||
2011年3月15日 (二) 16:39的版本
目录 |
badges
查看某个用户所获得的勋章列表
URL
http://api.t.sina.com.cn/badges.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
GET
是否需要登录
true
关于授权机制，参见授权机制声明
请求数限制
true
关于请求数限制，参见接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| source | true | string | 申请应用时分配的AppKey，调用接口时候代表应用的唯一身份。（采用OAuth授权方式不需要此参数） |
| uid | false | string | 查看用户的用户ID，默认为登录用户 |
| count | false | int | 单页返回的记录条数，默认值20，最大值200 |
| page | false | int | 返回结果的页码，默认值1 |
注意事项
{{{useAge}}}
返回结果
XML示例
<badges> <badge> <badge_id>12035</badge_id> <name>应用牛人</name> <description>开发一款超过100人使用的微博应用，即可获得</description> <link>http://t.cn/h4DwT1</link> <small_icon>http://ss16.sinaimg.cn/orignal/6374d2e9x90</small_icon> <middle_icon>http://ss16.sinaimg.cn/orignal/6374d2e9x91</middle_icon> <large_icon>http://ss16.sinaimg.cn/orignal/6374d2e9x92</large_icon> <deadline>Wed Jan 06 12:26:01+0800 2010</deadline> <is_show>true</is_show> <created_at>Wed Jan 06 11:26:01+0800 2010</created_at> </badge> … </badges>
JSON示例
[
{
”badge_id”: 12035,
”name”: ”应用牛人”,
”description”: ”开发一款超过100人使用的微博应用，即可获得”,
”link”: ”http://t.cn/h4DwT1”,
”small_icon”: ”http://ss16.sinaimg.cn/orignal/6374d2e9x90”,
”middle_icon”: ”http://ss16.sinaimg.cn/orignal/6374d2e9x91”,
”large_icon”: ”http://ss16.sinaimg.cn/orignal/6374d2e9x92”,
”deadline”: ”Wed Jan 06 12:26:01+0800 2010”,
”is_show”: true,
”created_at”: ”Wed Jan 06 11:26:01+0800 2010”
},
…
]
字段说明
- badge_id：勋章ID
- name：勋章名称
- description：勋章描述
- link：勋章活动页面链接地址URL
- small_icon：勋章小图标URL
- middle_icon：勋章中图标URL
- large_icon：勋章大图标URL
- deadline：勋章截止日期
- is_show：勋章是否显示
- created_at：勋章创建（授予）时间
其他
无
