小米帐户OAuth2.0文档.PDFVIP

小米帐户OAuth 2.0 文档 版本号：1.3 更新日期：2013-12-15 目录 1. OAUTH 2.0 概述 4 2. 授权接口说明6 2.1 授权流程说明6 2.1.1 授权码方式授权流程6 2.1.2 Implicit Grant方式授权流程6 2.2 授权接口说明8 2.2.1 请求用户授权接口8 2.2.2 获取访问令牌接口10 3. OAUTH 2.0 错误码13 4. MAC TOKEN 使用说明 15 4.1 MAC TOKEN 说明15 4.2 使用方法15 4.2.1 标准化字符串15 4.2.2 API 请求格式16 5. 小米账号的开放API 18 5.1 获取用户名片18 5.2 获取用户的关系列表19 5.3 获取用户OPEN ID 20 2013-12-15 | Copyright©2013 All Rights Reserved 2 表格目录 表 2-1 请求用户授权参数表 8 表 2-2 请求用户授权返回值表（RESPONSE_TYPE 为CODE ） 9 表 2-3 请求用户授权返回值表（RESPONSE_TYPE 为TOKEN ） 9 表 2-4 请求用户授权错误类型表 9 表 2-5 获取访问令牌参数表 10 表 3-1 OAUTH 2.0 错误码表 13 表 5-1 获取用户名片参数表 18 表 5-2 获取用户关系列表参数表 19 表 5-3 获取用户OPENID 参数表 20 表 5-4 验证用户密码接口参数表 21 图片目录 图 1-1 小米帐号授权流程图 4 图 2-1 授权码方式授权流程 6 图2-3 IMPLICIT GRANT 流程授权流程 7 2013-12-15 | Copyright©2013 All Rights Reserved 3 1 OAuth 2.0 概述 小米账号API 访问，如获取用户名片、获取米聊好友关系等都需要使用用 户身份，目前小米账号开放平台用户身份鉴权使用OAuth 2.0 。 关于OAuth 2.0 协议授权流程开发者可以先浏览OAuth 2.0 的接口文档，熟 悉OAuth 2.0 的接口及参数的含义，然后我们根据应用场景各自说明如何使用 OAuth 2.0 。 图 错误!文档中没有指定样式的文字。-1 小米帐号授权流程图 相关名词解释：  服务提供方(resource server): 用户使用服务提供方来存储受保护的资源， 这里指的是小米公司。  用户(user):存放在服务提供方的受保护的资源的拥有者。  客户端(client) ：要访问服务提供方资源的第三方应用，通常是网站在认 证过程之前，客户端要向服务提供者申请客户端标识。 2013-12-15 | Copyright©2013 All Rights Reserved 4  令牌（token ）：分发给客户端的代表访问授权的字符串。通常这个字符 串对客户端来说是不透明的。令牌代表资源拥有者许可的访问作用域和 持续时间，并由资源服务器和授权服务器强制保证。这个令牌可以代表 一个标识符，用于检索授权信息，或以一种可验证的方式自包含授权信 息（即一个包含数据和签名的令牌字符串）。令牌可能只代表纯粹的访 问能力。  访问令牌(acces