Weibo Platform Logo

微博开放平台

weibo
跳转到： 导航, 搜索
(→注意事项)
 
（未显示3个用户的23个中间版本）
第1行： 第1行：
−
=scope说明=
+
=授权 scope 功能说明=
  
−
scope是OAuth2.0授权机制中authorize接口的一个参数。
+
<div class="wiki_txtJ">
 +
scope 是 OAuth2.0 授权机制中 authorize 接口的一个参数。
  
  
−
通过scope，平台将开放更多的微博核心功能给开发者，同时也加强用户隐私保护，提升了用户体验，用户在新OAuth2.0授权页中有权利选择赋予应用的功能。
+
通过 scope 参数，平台可以提供更多的能力给开发者，同时用户也可以有选择的授权或者不授权不同的能力给第三方，即保障了用户对于隐私保护的需求，也提升了用户使用第三方应用的体验。
 +
</div>
  
−
=注意事项=
 
  
−
1:开发者需要先在应用控制台的接口管理中申请到相关的接口，才能使用scope功能。
+
==注意事项==
  
 +
<div class="wiki_txtJ">
 +
开发者需要先获取到相关接口的使用权限，才能使用 scope 功能，如果没有接口权限，调用时候会返回 10014 错误。满足使用条件后，开发者向用户请求授权时如果带上了 scope 参数，就会出现额外的 scope 授权确认项，当用户确定授权后，第三方就能正常调用对应的接口，反之会遇到 10032 错误。
 +
</div>
  
−
2:满足上一条后，开发者向用户请求scope权限，就会出现高级授权页面(如下图)
 
  
 
{{center|http://www.sinaimg.cn/blog/developer/wiki/oauth2v3_3.png}}
 
{{center|http://www.sinaimg.cn/blog/developer/wiki/oauth2v3_3.png}}
  
−
=scope权限接口=
 
  
 +
==scope参数说明==
  
−
可一次申请多个scope权限，用逗号分隔。
+
<div class="wiki_txtJ">
 +
开发者可一次申请多个 scope 权限，用逗号分隔。
 +
</div>
  
  
第28行： 第33行：
  
 
<tr>
 
<tr>
−
<td class="wiki_table_tdfirst">friendships_groups_read</td>
+
<td class="wiki_table_tdfirst">all</td>
−
<td>好友分组读取接口组</td>
+
<td>请求下列所有scope权限</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
−
<td class="wiki_table_tdfirst">friendships_groups_write</td>
+
<td class="wiki_table_tdfirst">email</td>
−
<td>好友分组写入接口组</td>
+
<td>用户的联系邮箱，[http://open.weibo.com/wiki/2/account/profile/email 接口文档]</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
−
<td class="wiki_table_tdfirst">statuses_to_me_read</td>
+
<td class="wiki_table_tdfirst">invitation_write</td>
−
<td>定向微博读取接口组</td>
+
<td>邀请发送接口，[http://open.weibo.com/wiki/Messages#.E5.A5.BD.E5.8F.8B.E9.82.80.E8.AF.B7 接口文档]</td>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
 
<td class="wiki_table_tdfirst">follow_app_official_microblog </td>
 
<td class="wiki_table_tdfirst">follow_app_official_microblog </td>
−
<td>关注应用官方微博</td>
+
<td>关注应用官方微博，该参数不对应具体接口，只需在应用控制台填写官方帐号，即可在授权确认页实现关注官方账号功能。填写的路径：我的应用-选择自己的应用-应用信息-基本信息-官方运营账号（默认值是应用开发者帐号）</td>
 
</tr>
 
</tr>
  
 
</table>
 
</table>
 +
 +
 +
==错误码说明==
 +
 +
<table class="wiki_table" border="0" cellspacing="0" cellpadding="0">
 +
 +
<tr>
 +
<th class="wiki_table_thfirst">错误信息</th>
 +
<th> 错误码</th>
 +
<th> 错误描述</th>
 +
</tr>
 +
 +
<tr>
 +
<td class="wiki_table_tdfirst">Insufficient app permissions</td>
 +
<td>10014</td>
 +
<td>第三方应用访问接口权限受限制，原因为应用没有对应的接口权限，需要联系微博商务进行申请</td>
 +
</tr>
 +
 +
<tr>
 +
<td class="wiki_table_tdfirst">access_denied</td>
 +
<td>10032</td>
 +
<td>用户或授权服务器拒绝授予数据访问权限，需要重新向用户申请 scope 权限</td>
 +
</tr>
 +
</table>
 +
 +
 +
 +
 +
 +
 +
{{#a:nobtns|noheading}}
 +
__NOTOC__

2022年10月11日 (二) 12:28的最后版本

授权 scope 功能说明

scope 是 OAuth2.0 授权机制中 authorize 接口的一个参数。


通过 scope 参数，平台可以提供更多的能力给开发者，同时用户也可以有选择的授权或者不授权不同的能力给第三方，即保障了用户对于隐私保护的需求，也提升了用户使用第三方应用的体验。


注意事项

开发者需要先获取到相关接口的使用权限，才能使用 scope 功能，如果没有接口权限，调用时候会返回 10014 错误。满足使用条件后，开发者向用户请求授权时如果带上了 scope 参数，就会出现额外的 scope 授权确认项，当用户确定授权后，第三方就能正常调用对应的接口，反之会遇到 10032 错误。


oauth2v3_3.png


scope参数说明

开发者可一次申请多个 scope 权限，用逗号分隔。


scope参数 描述
all 请求下列所有scope权限
email 用户的联系邮箱，接口文档
invitation_write 邀请发送接口，接口文档
follow_app_official_microblog 关注应用官方微博，该参数不对应具体接口，只需在应用控制台填写官方帐号，即可在授权确认页实现关注官方账号功能。填写的路径：我的应用-选择自己的应用-应用信息-基本信息-官方运营账号（默认值是应用开发者帐号）


错误码说明

错误信息 错误码 错误描述
Insufficient app permissions 10014 第三方应用访问接口权限受限制，原因为应用没有对应的接口权限，需要联系微博商务进行申请
access_denied 10032 用户或授权服务器拒绝授予数据访问权限，需要重新向用户申请 scope 权限





来自“http://open.weibo.com/wiki/index.php?title=Scope&oldid=16309”
文档更新时间: 2022-10-11

关于微博开放平台| 联系我们| 服务条款| 无线游戏| 开放平台官微

京网文 [2011] 0398-130号 京ICP证100780号 Copyright © 1996-2024 SINA