更新文档

服务参考_临时/openapi.yaml

@@ -1,11 +1,12 @@
 openapi: 3.0.3
 info:
   title: Brisk Game Service API
-  version: 0.1.0
+  version: 0.2.0
   description: Current implemented Brisk server API for internal integration.
 servers:
   - url: /api
 tags:
+  - name: time
   - name: bootstrap
   - name: auth
   - name: player
@@ -51,6 +52,21 @@ components:
           type: string
         data:
           nullable: true
+    ClientTimePayload:
+      type: object
+      properties:
+        server_time:
+          type: string
+          format: date-time
+          example: 2026-04-11T08:12:30Z
+        server_unix:
+          type: integer
+          format: int64
+          example: 1775895150
+        server_unix_ms:
+          type: integer
+          format: int64
+          example: 1775895150123
     ExchangeRequest:
       type: object
       required: [game_key, login_provider]
@@ -494,6 +510,28 @@ components:
           type: string
           format: date-time
 paths:
+  /client/time:
+    get:
+      tags: [time]
+      summary: Get platform server time
+      responses:
+        '200':
+          description: Current platform UTC time
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code:
+                    type: integer
+                    example: 0
+                  message:
+                    type: string
+                    example: ok
+                  data:
+                    $ref: '#/components/schemas/ClientTimePayload'
+        '429': { description: Rate limited }
+        '500': { description: Rate limit unavailable }
   /client/bootstrap:
     get:
       tags: [bootstrap]