wip

2026-08-17 20:25:40 +04:00
parent 9e36265f81
commit 6a73d760c4
7 changed files with 366 additions and 0 deletions
@@ -404,6 +404,81 @@
                ]
            }
        },
+        "/api/launcher/game-ticket": {
+            "post": {
+                "tags": [
+                    "Launcher Auth"
+                ],
+                "summary": "Issue a single-use game login ticket",
+                "description": "Creates short-lived SRP credentials for authserver. A new ticket atomically revokes the previous generation. The plaintext ticket is never stored.",
+                "operationId": "7b54b9b05714077ff61483260a0e64a7",
+                "requestBody": {
+                    "required": true,
+                    "content": {
+                        "application/json": {
+                            "schema": {
+                                "required": [
+                                    "client_build"
+                                ],
+                                "properties": {
+                                    "client_build": {
+                                        "type": "integer",
+                                        "example": 12340
+                                    }
+                                },
+                                "type": "object"
+                            }
+                        }
+                    }
+                },
+                "responses": {
+                    "200": {
+                        "description": "Ticket issued",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "required": [
+                                        "account",
+                                        "ticket",
+                                        "expires_at"
+                                    ],
+                                    "properties": {
+                                        "account": {
+                                            "type": "string",
+                                            "example": "PLAYERONE"
+                                        },
+                                        "ticket": {
+                                            "type": "string",
+                                            "pattern": "^[A-Z0-9]{16}$",
+                                            "example": "7W6D4M2Q9K8R3X5Z"
+                                        },
+                                        "expires_at": {
+                                            "type": "string",
+                                            "format": "date-time"
+                                        }
+                                    },
+                                    "type": "object"
+                                }
+                            }
+                        }
+                    },
+                    "401": {
+                        "description": "Launcher authentication required"
+                    },
+                    "422": {
+                        "description": "Client build is not allowed"
+                    },
+                    "429": {
+                        "description": "Too many requests"
+                    }
+                },
+                "security": [
+                    {
+                        "bearerAuth": []
+                    }
+                ]
+            }
+        },
        "/api/launcher/news": {
            "get": {
                "tags": [