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
}

其他