滑动续期、网络错误归类、API Key 激活乐观锁与生效提示

docs/swagger.yaml

@@ -1700,6 +1700,11 @@ definitions:
         type: string
       id:
         type: integer
+      keyActivatedAt:
+        description: |-
+          KeyActivatedAt 是最近一次启用新签名 key(面板轮换激活或手工替换私钥)
+          的时刻;OCI 公钥全球传播为分钟级,前端据此在窗口期内提示,nil 表示未记录
+        type: string
       lastError:
         type: string
       lastVerifiedAt:
@@ -3144,7 +3149,8 @@ definitions:
 info:
   contact: {}
   description: '自托管 OCI 多租户管理面板 API。业务接口用 JWT(Bearer);AI 网关端点(/ai/v1/*)用独立网关密钥(Authorization:
-    Bearer 或 x-api-key)。'
+    Bearer 或 x-api-key)。令牌滑动续期:剩余有效期不足 12h 时,GET/HEAD 鉴权响应附带 X-Renewed-Token / X-Renewed-Expires-At
+    头,客户端仅在 2xx 响应以其替换本地会话。'
   title: OCI Portal API
   version: 0.8.3
 paths: