接口详情

登录地址构造

一个完整的登录认证地址由下面几个部分组成： {认证地址}?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): 返回结果:

{
  "code": 200,
  "data": {
    "access_token": "string",     //token
    "expires_in": 0,                    //有效期
    "expiry": "string",                 //过期时间
    "refresh_token": "string",    //刷新token
    "scope": "string",                //权限
    "token_type": "Bearer"
  },
  "message": "string",
  "result": True
}```

# **token换取用户信息**
用token换取用户信息有两种方式,get和post
请求路由: https://api.uniontech.com/v1/user
post 方式请求参数
返回结果:
```json
{
    "unionid":  //与公司相关联的用户id
    "openid":  //与产品相关联的用户id
    "username":  //用户名称
    "nickname":  //用户昵称
    "email":  //用户注册时填写邮箱（该字段不一定有，只有拥有user.api:contact权限时才有）
    "phone_number":  //用户注册时填写手机号（该字段不一定有，只有拥有user.api:contact权限时才有）
    "region":  //帐号注册区域，分为cn和de，cn表示中国大陆，de表示国外区域
    "profile_image":  //用户头像
}```

# **帐号退出**
调用帐号退出接口清除UOS ID的登录信息
请求路由: https://login.uniontech.com/logout 
1、web应用，直接跳转到https://login.uniontech.com/logout 这个地址即可，跳转过去之后自动会带上当前登录用户的Cookie信息。
2、接口请求，get方式，需要携带当前登录用户的令牌（Cookie）
返回结果: 200