# 认证中心接入文档

> 当前部署内置文档。链接相对于当前站点；只描述公开协议，不包含真实凭据。

## 开始接入

- [按角色完成购买、开发与审核任务](/docs/tasks.md): 区分注册邀请、软件权益、应用奖励兑换码；购买后使用、开发者申请及管理员对账的下一步。
- [应用登录与用户字段映射](/docs/login.md): 配置 OIDC 登录、scope、用户 ID、昵称、邮箱及常见接入错误。
- [登录与授权接口参考](/docs/integration-api.md): 逐项查看请求、响应字段、认证条件、示例与错误码；下载 OpenAPI。
- [应用接入与软件授权指南](/docs/integration.md): OAuth、授权查询、扣减、设备域名绑定及外部适配。
- [永久授权恢复与单设备在线租约](/docs/license-leases.md): 当前用户与应用权益恢复、租约获取/心跳/释放、严格换机及旧客户端兼容边界。
- [应用奖励兑换码与 CDK 接入](/docs/redemption-codes.md): 应用后端校验与原子核销、幂等发奖、管理权限和历史快照边界。
- [软件版本与安装包](/docs/releases.md): 版本发布、更新检查、下载与存储配置。
- [机器发布与流水线接入](/docs/machine-releases.md): 应用级机器令牌、CI 上传、幂等与发布边界。
- [机器版本接口参考](/docs/machine-api.md): 从已有 OpenAPI 契约生成的机器发布接口参考。
- [系统设置与帮助文档](/docs/settings.md): 配置补充 Wiki，理解内置帮助、权限及保存行为。
- [第三方登录与应用接入的区别](/docs/providers.md): 分清平台作为登录提供方或第三方登录客户端的两种方向。
- [图片上传与存储](/docs/image-storage.md): 头像、商品和门户图片的用途、限制与存储配置。
- [门户方案与发布](/docs/portal-config.md): 保存、复制和切换门户方案，区分未保存、已保存与已发布状态。
- [注册与 SMTP 配置](/docs/smtp.md): 注册邮箱验证、发信配置、状态与测试。
- [首次运行自检](/docs/setup-check.md): 检查数据库、邮件、支付、存储和第三方登录配置。
- [浏览器基础 API](/docs/browser-api.md): 会话 Cookie、CSRF 与基础认证接口记录；不是完整 OpenAPI 契约。
- [Gitea OIDC 兼容说明](/docs/gitea.md): 旧机密客户端 PKCE/nonce 兼容边界与回调地址。
- [工作台与角色权限](/docs/workspaces.md): 个人工作台与管理工作台的导航、权限和功能分组。
- [账号二次验证与恢复](/docs/mfa.md): 绑定身份验证器、一次性恢复码、登录挑战与账号恢复。
- [开发者会员与应用管理](/docs/developer.md): 体验与套餐、会员权益、应用登录、软件更新、自带S3和小程序。

## 机器可读接口契约

- [登录与授权接口参考](/docs/integration.openapi.json)
- [机器版本接口参考](/docs/machine-releases.openapi.json)

OpenAPI 仅覆盖标明的接口范围；其余指南不是完整接口契约。接入时先确认当前部署版本、认证方式、scope 与响应包装，不使用数据库字段猜测公开响应。