访问码与二维码

这些接口用于生成访问码，或把网页端获取的机台二维码绑定到当前账号。它们只接受当前账号有权使用的数据。

生成长期访问码

接口

POST /aimedb/reg

请求体

{
  "token": "<TOKEN>"
}

响应

{
  "success": true,
  "msg": "success",
  "accessCode": "<ACCESS_CODE>"
}

客户端可以把 accessCode 交给二维码生成器或直接交给网页显示层，不要在服务端日志中记录完整值。

生成临时访问码

接口

POST /aimedb/reg-temp

请求体

{
  "token": "<TOKEN>"
}

返回结构与长期访问码相同。临时访问码的有效期由服务端策略决定；客户端应在过期后重新生成，而不是缓存很久。

使用二维码内容绑定网页登录

接口

POST /aimedb/reg-token

请求体

{
  "SGWCMAID": "<QR_TEXT>",
  "clientId": "<MACHINE_ID>",
  "token": "<TOKEN>",
  "cf_token": "<TURNSTILE_TOKEN>",
  "customAimeUrl": ""
}

字段	类型	必填	说明
SGWCMAID	string	是	页面读取到的二维码文本
clientId	string	是	当前机台标识
token	string	是	当前用户 Token
cf_token	string	是	人机验证结果
customAimeUrl	string	否	自定义服务地址，不确定时留空

成功响应：

{
  "success": true,
  "msg": "success"
}

注意事项

• SGWCMAID 只应来自本人或已获授权的二维码；
• clientId 不要从其他机台复制；
• 访问码与 Token 都属于敏感凭据；
• 如果接口返回人机验证错误，请重新打开页面获取新的验证结果。