开发者登录令牌获取：请提前准备`2FA绑定工作`

权限组 API 路径ID 20 方法ID 01

请求域：vip.youloge.com 请求头：authorization:Youloge-API {ukey}

作用域：login/captcha

错误编号：2020 00 频率限制: 10

该接口仅用于开发者账户首次初始化使用

开发者令牌有效期 7天无限续签;服务端数据解密。
每5分钟允许重新获取一次签名：signertrue只能自己解密,只有不帮密钥泄露，就不怕被爆破.
signertrue => ticket通过[续签同步](./refresh)接口更新令牌获得ticket(7天有效);
signertrue => ticket通过[授权登录](./authorize)接口授权令牌获得Singer(默认2小时有效：支持自定义有效期);

使用定时任务定时刷新开发者令牌

开发者续签刷新令牌机制与普通用户续签机制相同;

请求代码

http

POST /login/captcha HTTP/1.1
Host: api.youloge.com
Lang: zh-CN
Content-Type: application/json
authorization:Youloge-API {{ukey}}
{
  "code":"" // 2FA 密码
}

响应代码

json

{
  "err": 200,
  "msg": "开发令牌",
  "data": {
    "signertrue": "DcQlwu6o7hWu+JNyP******",
    "expire": 1692210923
  }
}

signertrue 通过解密可以获得 uuid=>UkeyUUID,ticket 令牌,expire 7天
适用范围：DEV开发者接口专用

错误代码

json

{
  "err": 202000,
  "msg": "2FA 密码错误",
}

其他错误码

错误err	描述msg	说明
202000	2FA 密码错误	检查2FA 是否绑定正确
202001	验证次数超限	每5分钟只能验证一次

开发者令牌的获取与保存

获取开发者令牌需要先登录，登录需要匿名人机授权，匿名人机授权需要先有开发者令牌

防止陷入死循环首次签名：请使用[开放umd组件库/单点登录]或使用[UI组件库/PLUS组件]
平台开发者令牌和用户令牌其实是一个东西，区别在于登录邮箱是否一致：
开发者令牌与用户令牌的使用一致：授权令牌7天(建议服务端保存,随时续签) 签名令牌3小时
同一个开发者名下所有ukey主动互相授权登录：注意授权后只能使用对应ukey-secret解密

获取开发者令牌

使用http-server启动本地http服务

点击查看完整html代码

html

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Document</title>
</head>
<body>
  <div>
    <div id="login" style="height: 600px;width: 400px;margin: 0 auto;"></div>
  </div>
  <script src="https://unpkg.com/youloge.plus"></script>
  <script>
    let PLUS = youloge.plus({
      ukey:''
    });
    PLUS.sso({
      selector:'#login'
    }).then(res=>{
      console.log(res)
    }).catch(err=>{
      console.log(err)
    });
    console.log(PLUS)
  </script>
</body>
</html>

获取临时匿名令牌(人机/防刷验证)

点击查看完整html代码

html

实战应用：

我已有一个网站(邮箱体系),现在想无缝接入Github 登录 Google登录
1. 前端正常让用户点击跳转到Github 登录：后端使用code 换取Github用户资料
1.1. 老用户在有效期内网站直接使用profile.signature 解密得到 profile.signer进行登录;或者续期profile.secret=>Signer+API:authorize授权登录
1. 新用户使用获得用户邮箱使用VIP:code发送登录邮件,得到random access
2.1 前端提示用户输入5位验证码 + access => API:verify得到secret 保存到用户利用profile.secret=>Signer+API:authorize=>signature授权登录
你可能觉得繁琐拆分分的十分琐碎：这是因为接口面向多应用设计的，例如解密profile.signature=>Signer这个Signer + 任意其他Ukey即可完成另一个系统授权登录，可以实现一处登录处处可用

开发者登录令牌获取：请提前准备2FA绑定工作 ​

请求代码 ​

响应代码 ​

错误代码 ​

开发者令牌的获取与保存 ​

获取开发者令牌 ​

获取临时匿名令牌(人机/防刷验证) ​

实战应用： ​

推荐使用方式 ​