wip

2026-08-17 20:25:08 +04:00
parent b64dffca9a
commit 25e7ad156b
12 changed files with 368 additions and 13 deletions
@@ -109,6 +109,83 @@
                }
            }
        },
+        "/api/launcher/game-ticket": {
+            "post": {
+                "tags": [
+                    "Launcher Auth"
+                ],
+                "summary": "Выпустить одноразовый ticket для входа в игру",
+                "description": "Отзывает предыдущий неиспользованный ticket аккаунта и возвращает временный SRP-пароль. Ticket не сохраняется и действует не более 60 секунд.",
+                "requestBody": {
+                    "required": true,
+                    "content": {
+                        "application/json": {
+                            "schema": {
+                                "required": [
+                                    "client_build"
+                                ],
+                                "properties": {
+                                    "client_build": {
+                                        "type": "integer",
+                                        "example": 12340
+                                    }
+                                },
+                                "type": "object"
+                            }
+                        }
+                    }
+                },
+                "responses": {
+                    "200": {
+                        "description": "Одноразовая игровая авторизация",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "required": [
+                                        "account",
+                                        "ticket",
+                                        "expires_at"
+                                    ],
+                                    "properties": {
+                                        "account": {
+                                            "type": "string",
+                                            "example": "PLAYERONE",
+                                            "maxLength": 17,
+                                            "minLength": 1
+                                        },
+                                        "ticket": {
+                                            "type": "string",
+                                            "pattern": "^[A-Z0-9]{16}$",
+                                            "example": "A1B2C3D4E5F6G7H8"
+                                        },
+                                        "expires_at": {
+                                            "type": "string",
+                                            "format": "date-time",
+                                            "example": "2026-08-16T12:01:00Z"
+                                        }
+                                    },
+                                    "type": "object"
+                                }
+                            }
+                        }
+                    },
+                    "401": {
+                        "description": "Launcher-сессия отсутствует или истекла"
+                    },
+                    "422": {
+                        "description": "Версия клиента не разрешена"
+                    },
+                    "429": {
+                        "description": "Слишком много запросов"
+                    }
+                },
+                "security": [
+                    {
+                        "launcherAuth": []
+                    }
+                ]
+            }
+        },
        "/api/launcher/manifest": {
            "get": {
                "tags": [
@@ -702,4 +779,4 @@
            "description": "Launcher Service"
        }
    ]
-}
+}