wangjia
58c6eb721e
feat: 新增 server/api/openapi.yaml — v1 API 完整契约(tsk_A1HkEdRbXLGY)
OpenAPI 3.0.3，覆盖 doc/02 §2 全部 15 个操作：
- 认证 4（sendVerificationCode/register/login/refreshToken，security:[]）
- 账户 3（getMe/listDevices/deleteDevice）
- 商业 3（redeemCode/adsUnlock/listPlans）
- 节点 3（listNodes 含 304/connectNode/disconnectNode）
- 用量 1（getUsage）、公告 1（listNotices）
全量 schema：Error·TokenPair·Me·UserInfo·SubscriptionInfo·TodayUsageSummary·
Device·Plan·RedeemResult·NodeDirectory·Node·ConnectCredential·
RealityParams·Hysteria2Params·UsagePoint·Notice
安全约定：bearerAuth(JWT RS256) 全局；auth 四操作 security:[]；
components/responses 统一 Error 引用；429 TooManyRequests 带 Retry-After；
节点目录不含密钥，密钥仅由 connect 端点下发；对外 ID 全部 uuid 格式。
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>