百度智能小程序开发服务 百度OAuth授权说明
流程示意图
以下是智能小程序使用OAuth 2.0进行授权及获取用户信息的示意图。
相关概念
OAuth 2.0（开放授权）：一个开放登录授权标准。用户授权后，第三方智能小程序无需获取用户的用户名和密码就可以访问该用户。
Session Key：用户对智能小程序的授权会话的密钥。用户授权后，开发者可以通过百度开放平台获取授权会话的Session Key，此后便可在智能小程序中获取用户信息。
Code：用户授权的标识。在用户完成对应用的授权后，会生成一个很短时间（十分钟）内有效的授权标识，开发者通过服务端请求，将code以及智能小程序的client_id和secret_key传到开放平台接口，可以获取到SessionKey。
使用百度授权前准备
您需要创建一个智能小程序以获取client_id（AppKey）和client_secret（AppSecret），以上两者均从智能小程序开发者后台查看。
智能小程序在App内部运行时的授权流程
智能小程序在App内部运行时采用Authorization Code获取SessionKey的授权验证。
对于智能小程序而言，其流程由获取Authorization Code，和通过Authorization Code获取Session Key这2步组成。
第一步：获取Authorization Code
智能小程序可以使用swan.login()接口获取Authorization Code。
第二步：通过 Authorization Code 获取 Session Key
智能小程序在其服务端中发送POST请求到百度 OAuth2.0 授权服务地址，并带上对应的参数，便可获取到Session Key。
获取Session Key的URL地址：
https://openapi.baidu.com/nalogin/getSessionKeyByCode
获取Session Key需要的参数：
| 参数名 | 是否必须 | 说明 |
|---|---|---|
| code | 是 | 通过上面第一步所获得的Authorization Code |
| client_id | 是 | 智能小程序的App Key |
| sk | 是 | 智能小程序的App Secret |
若参数无误，服务器将返回一段JSON文本，包含以下数据：
| 字段名 | 说明 |
|---|---|
| session_key | 用户的Session Key |
若请求错误，服务器将返回一段JSON文本，包含以下参数：
| 字段名 | 说明 |
|---|---|
| error | 错误码；关于错误码的详细信息请参考”错误码列表”一节。 |
| error_description | 错误描述信息，用来帮助理解和解决发生的错误。 |
第三步：获取用户信息
完成上述两步之后，小程序可调用swan.getUserInfo()方法获取用户信息
再次获取用户信息
当用户完成了授权，且授权会话仍处于有效期时，智能小程序不需要每次都进行前两步，而是可以直接进行第三步获取用户信息。
要判断当前用户的授权会话是否仍处于有效期，可调用checkSession()方法进行判断。
错误码列表
| 错误码 | 错误信息 | 详细描述 |
|---|---|---|
| invalid_request | invalid refresh token | 请求缺少某个必需参数，包含一个不支持的参数或参数值，或者格式不正确。 |
| invalid_client | unknown client id | client_id、client_secret 参数无效。 |
| invalid_grant | The provided authorization grant is revoked | 提供的 Access Grant 是无效的、过期的或已撤销的，例如，Authorization Code 无效(一个授权码只能使用一次)、Refresh Token 无效、redirect_uri 与获取 Authorization Code 时提供的不一致、Devie Code 无效(一个设备授权码只能使用一次)等。 |