новости

openapi.json

@@ -197,8 +197,8 @@
                 "tags": [
                     "Launcher"
                 ],
-                "summary": "Скачать файл клиента",
-                "description": "Стримит файл из S3 по относительному пути из манифеста. Путь может содержать вложенные директории (например `Data/ruRU/patch-ruRU-3.MPQ`).",
+                "summary": "Получить ссылку на скачивание файла",
+                "description": "Возвращает временную presigned-ссылку на файл в S3. Лаунчер скачивает файл напрямую из хранилища по этой ссылке. Путь может содержать вложенные директории (например `Data/ruRU/patch-ruRU-3.MPQ`).",
                 "operationId": "9a94331833a7af795c1c57dfa3a77eb3",
                 "parameters": [
                     {
@@ -214,12 +214,23 @@
                 ],
                 "responses": {
                     "200": {
-                        "description": "Бинарное содержимое файла",
+                        "description": "Временная ссылка на скачивание",
                         "content": {
-                            "application/octet-stream": {
+                            "application/json": {
                                 "schema": {
-                                    "type": "string",
-                                    "format": "binary"
+                                    "properties": {
+                                        "url": {
+                                            "description": "Presigned URL для скачивания",
+                                            "type": "string",
+                                            "format": "uri"
+                                        },
+                                        "expires_in": {
+                                            "description": "Время жизни ссылки в секундах",
+                                            "type": "integer",
+                                            "example": 3600
+                                        }
+                                    },
+                                    "type": "object"
                                 }
                             }
                         }
@@ -263,6 +274,81 @@
                     }
                 ]
             }
+        },
+        "/api/launcher/news": {
+            "get": {
+                "tags": [
+                    "Launcher"
+                ],
+                "summary": "Список новостей лаунчера",
+                "description": "Возвращает опубликованные новости для отображения в лаунчере. Отсортированы по sort_order и дате создания.",
+                "operationId": "69aa09e0c7cca466e8a45a186444245e",
+                "responses": {
+                    "200": {
+                        "description": "Список новостей",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "properties": {
+                                        "data": {
+                                            "type": "array",
+                                            "items": {
+                                                "properties": {
+                                                    "id": {
+                                                        "type": "integer",
+                                                        "example": 1
+                                                    },
+                                                    "title": {
+                                                        "type": "string",
+                                                        "example": "Обновление 1.2"
+                                                    },
+                                                    "body": {
+                                                        "type": "string",
+                                                        "example": "Описание обновления..."
+                                                    },
+                                                    "image_url": {
+                                                        "type": "string",
+                                                        "format": "uri",
+                                                        "example": "https://storage.yandexcloud.net/warcraft-client/news/update-1.2.jpg",
+                                                        "nullable": true
+                                                    },
+                                                    "created_at": {
+                                                        "type": "string",
+                                                        "format": "date-time"
+                                                    }
+                                                },
+                                                "type": "object"
+                                            }
+                                        }
+                                    },
+                                    "type": "object"
+                                }
+                            }
+                        }
+                    },
+                    "401": {
+                        "description": "Не авторизован",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "properties": {
+                                        "message": {
+                                            "type": "string",
+                                            "example": "Unauthenticated."
+                                        }
+                                    },
+                                    "type": "object"
+                                }
+                            }
+                        }
+                    }
+                },
+                "security": [
+                    {
+                        "bearerAuth": []
+                    }
+                ]
+            }
         }
     },
     "components": {