接入路径
在 api_clients 表中注册 FrameX 客户端,配置回调地址,然后引导用户访问 /oauth/authorize。占位配置已就绪,填入真实凭据即可启用生产流量。
- 创建 OAuth 客户端,登记回调地址并保存密钥哈希。
- 携带 state 与可选的 S256 code challenge,将用户重定向到 /oauth/authorize。
- 在 /api/v1/oauth/token 换取令牌,然后调用 /api/v1/oauth/userinfo。
授权 / 令牌
本项目不包含任何生产 FrameX 密钥。请使用 bin/create-client.php 创建客户端,并将密钥保存在服务器环境变量中。
GET
https://account.yanshiyi.com/oauth/authorize
POST
https://account.yanshiyi.com/api/v1/oauth/token
GET
https://account.yanshiyi.com/api/v1/oauth/userinfo
POST
https://account.yanshiyi.com/api/v1/oauth/revoke
完整请求示例与客户端创建命令见 README.md。
内部登录
使用内部账号接口完成服务间认证,或通过 OAuth 2.0 接入 FrameX。
POST
https://account.yanshiyi.com/api/v1/internal/login