账号及用户服务配置
更新时间:2018-03-15 20:34:06
配置入口
- 在APP中创建版本配置后,点击“配置”
- 选择资源变更,点击“开发”
- 找到移动应用推送服务,点击“配置”:
自有账号对接
控制台配置
用户服务基于Oauth2.0 API协议提供厂商三方自有账号对接功能, 支持厂商仅使用自有账号,或同时使用账号服务和自有账号。若需使用三方自有账号功能,可在开启用户服务后进行自有账号对接的配置。
步骤1:在开发环境选择需使用自有账号的应用,点击自有账号对接
- 步骤2:完成自有账号对接的相关参数配置并确认保存,其中访问/刷新URL和 GetuserinfoURL 需厂商提供前缀,详细对接文档请参考下文
- 步骤3:在开发环境进行测试,若测试成功需再在生产环境配置一遍。
三方账号登录流程说明
第一步
获取Authorization Code,此步骤由三方厂商直接下发。
第二步
1、通过Authorization Code获取Access Token
URL如:https://third.com/oauth2.0/get\_access\_token,querystring根据厂商的配置信息自动拼接,注意字段名称需匹配。
请求方法:Get
请求参数:
grant_type=authorization_code (此为固定值)
client_id 即appKey
client_secret 即appSecret
refresh_token 用于刷新access_token
返回说明:如果成功返回,即可在返回包中获取到Access Token,如:
字段说明 | 类型 | 描述 |
---|---|---|
access_token | String | 授权令牌,Access_Token。 |
expires_in | String | 该access token的有效期,单位为秒。 |
refresh_token | String | 在授权自动续期步骤中,获取新的Access_Token时需要提供的参数。 |
openid | String | 用户唯一标识 |
result_code/message | String | 公共结果码和Message |
2、刷新access_token(权限自动续期)
URL与获取AccessToken一致,但grant_type不同。
URL如:https://third.com/oauth2.0/get_access_token,querystring根据厂商的配置信息自动拼接, 注意字段名称需匹配。
请求方法:Get
请求参数:
grant_type=refresh_token (本步骤中为refresh_token)
client_id 即appKey
client_secret 即appSecret
refresh_token 获取accessToken返回的refresh_token
返回说明:
参数说明 | 描述 |
---|---|
access_token | 授权令牌,Access_Token。 |
expires_in | 该access token的有效期,单位为秒。 |
refresh_token | 在授权自动续期步骤中,获取新的Access_Token时需要提供的参数。 |
result_code/message | 公共结果码和Message |
第三步
通过access_token、openid获取用户信息
URL如:https://thrid.com/sns/userinfo
请求参数:
access_token 必须
openid 必须
返回JSON数据:
{
"result_code": "0" 字符串
"message": "成功",
"openid":" OPENID", 字符串类型,必须
"nick_name": NICKNAME, 字符串类型 必须
"mobile":"1xxx", 字符串类型 可选
"avatar_url": "image.com/xxxx.png" 可选
"gender": "1" 1: 男 2:女 0:未知
}
公共返回结果码约定
结果码 | 说明 |
---|---|
0 | 成功 |
100001 | AccessToken过期 |
100002 | 用code换取access token值失败 |
100003 | RefreshToken已过期或已失效 |
100004 | 用户改密或解除授权导致AccessToken失效 |
100005 | AccessToken非法 |
100006 | 无效的OpenId |
110000 | 系统通用错误(无法--列出其他所有错误,需联系三方ISV |