Badges/app/remove
目录 |
badges/app/remove
第三方应用向指定的一个或多个用户收回一枚第三方应用勋章
URL
http://api.t.sina.com.cn/badges/app/remove.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
POST
是否需要登录
true
关于授权机制,参见授权机制声明
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数) |
uids | true | string | 颁发的用户uid,支持1-100个用户,用逗号分隔,必填 |
badge_id | true | string | 勋章ID,必填 |
注意事项
操作勋章的登录帐号必须为该appkey的创建者;
只能操作绑定该appkey的勋章,并且该勋章正常可用; 支持同时授予1-100个用户; 未通过审核的开发中应用:
- 测试勋章只能收回于测试账号和应用创建者自己;
通过审核的应用:
- 勋章只能收回于该应用的授权用户和应用创建者自己;
返回结果
XML示例
<badge_id>12035</badge_id>
JSON示例
{ ”badge_id”: 12035 }
其他
无