网易邮箱账号OAuth2.0认证文档

认证流程

OAuth2.0认证分为3个步骤:

1)用户授权并获取code

2)使用code换取access_token

3)使用access_token获取用户信息

用户授权并获取code

URL：

http://reg.163.com/open/oauth2/authorize.do

HTTP请求方式:

GET

请求参数：

参数	意义
client_id	分配给第三方的key
redirect_uri	授权流程结束后跳转的URL。redirect_uri所在的域名必须与申请OAuth认证邮件中网站域名一致
response_type	此值固定为"code"
state（可选）	用于保证请求和回调用户状态统一，建议商家在state值中加入用户状态或使用session存储state值。这个参数可用于防止跨站请求伪造（CSRF）攻击

返回值：

参数	意义
code	获取的Code
state	如果请求中传了state参数，会回传该参数用于校验

返回示例：

http://YOUR_CALBACK_URL?code=A_CODE_GENERATED_BY_SERVER

错误时返回值：

参数	意义
error	错误类型
error_description	错误描述

错误时返回示例：

http://YOUR_CALBACK_URL?error=invalid_client&error_description=client+identifier+is+invalid

使用code换取access_token

URL：

http://reg.163.com/open/oauth2/token.do

HTTP请求方式:

POST

请求参数：

参数	意义
client_id	分配给第三方的key
client_secret	分配给第三方的secret
grant_type	此值固定为"authorization_code"
code	第一步返回的code值
redirect_uri	必须与第一步所传redirect_uri参数一致

返回值：

参数	意义
access_token	获取的Access Token
expires_in	Access Token过期时间

返回示例：

{"expires_in":5184000,"access_token":"dab93a1e30960af28e6a975faeaf7c25"}

使用Access Token获取用户信息

URL：

https://reg.163.com/open/oauth2/getUserInfo.do

HTTP请求方式:

GET

请求参数：

参数	意义
access_token	第二步获得的access_token

返回值：

参数	意义
userId	用户数字Id(长度不会超过15位)
username	用户账户名称(如果用户在登录的时候不选择共享账户名称，则只返回userId，所以请以userId作为用户的唯一标识)

返回示例：

{"username":"urstest_mreg","userId":"820014421"}（如果用户在登录的时候不选择共享账户名称，则返回：{"userId":"820014421"}）

申请OAuth认证

申请OAuth认证需要发送邮件到passport@service.netease.com, 邮件规范如下：

a. 申请邮件主题统一为“申请OAuth认证”;

b. 邮件内容必须按照如下模板：

    1)网站名称:__________________

    2)网站域名:__________________

    3)网站经营单位:__________________

    4)网站描述(不要超过85个字符):__________________

    5)网站的80*80px在线连接logo的url:__________________

    6)负责人姓名、手机号以及邮箱:__________________

    7)申请人同意(邮件内容必须包含下面这段话)：

        网易公司有完全权利根据申请人提交的信息审核通过、不通过，或随时终止给予申请人的授权和服务，且不对有关服务的稳定性、可持续性做任何明示或暗示的保证。

        申请人保证申请网站及其相关接口、通道的合法性、安全性、稳定性，否则给网易公司造成的损失应予以赔偿；申请人完成申请、获准通过后，应根据网易公司提供的信息数据进行开发，不得擅自变更用户登录网易邮箱账号的页面，不得以任何方式截取、搜集、保存网易邮箱账号用户的任何用户数据；申请人自行完成登录结果信息的数据项校验并独立承担后果。

        网易公司拥有网易邮箱账号服务相关的一切权利，包括但不限于：网易邮箱账号用户登录数据以及其它用户数据、文字、软件、声音、图片、录像、图表、广告、电子邮件，等的全部内容。

c. 请严格按照以上规范，否则不予受理，审核通过后，我们会为您分配相应的Consumer key和secret