users/set_top_status
设置当前用户主页置顶微博
URL
https://api.weibo.com/2/users/set_top_status.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:高级接口(需要授权)
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得。 |
id | true | int64 | 需要设置为置顶微博的微博ID。 |
注意事项
- 由于weibo.com个人页有1天缓存原因,导致调用成功后界面仍看不到效果,后期会去掉此缓存;
- 只能操作当前登录用户;
- 一个用户同时只能置顶一条微博;
- 普通用户有且仅有一次可置顶的试用机会,置顶时长为24小时;
- 当用户状态为会员时,使用置顶功能,不受次数、时间限制;
调用样例及调试工具
返回结果
JSON示例
{ "result": true }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
无
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问