接口详情

登录地址构造

一个完整的登录认证地址由下面几个部分组成：

{认证地址}?client_id=&redirect_uri=&response_type=code&scope=&state

client_id:客户端在授权服务器注册应用后获取到的对应id

redirect_uri:客户端在授权服务器注册应用时填写的应用回调地址

response_type:固定为code

scope:当前应用申请令牌需要获取到的访问权限集合，不可大于注册应用时，获取到的权限集合，权限通过“,”，“;”，“ ”进行拼接,scope可以通过()对照表获取,例如开放平台中仅申请了用户基本权限,则scope=user.api:base 如果有用户基本权限和用户隐私权限,则scope=user.api:base,user.api:contact （需进行Url编码处理）

state:状态参数，如果设置会随回调地址一起返回(必须设置该参数，且该参数是随机的，在回调地址中需要验证该参数是否是系统颁发)

登录地址示例:

http://login.uniontech.com/oauth2/authorize?client_id=0479843273a140b7a3fcf3011df9a58a&redirect_uri=http%3A%2F%2F127.0.0.1%3A10010%2Fcallback&response_type=code&scope=scope%3Duser.api%3Abase%2Cuser.api%3Acontact&state=c7cfec43648842c1a5346728e6f5bf32

用code换取token接口(刷新token令牌)

请求路由:

post https://login.uniontech.com/api/oauth2/tokens

请求参数(参数类型:application/x-www-form-urlencoded):

返回结果:

token换取用户信息

用token换取用户信息有两种方式,get和post

请求路由: https://api.uniontech.com/v1/user

post 方式请求参数

返回结果:

帐号退出

调用帐号退出接口清除Union ID的登录信息

请求路由: https://login.uniontech.com/logout

1、web应用，直接跳转到https://login.uniontech.com/logout 这个地址即可，跳转过去之后自动会带上当前登录用户的Cookie信息。

2、接口请求，get方式，需要携带当前登录用户的令牌（Cookie）

返回结果: 200