# Fingerprints

## Згенерувати новий відбиток (ОС хоста)

`GET /fingerprint/new`

```json
{
  "tags": [
    "Fingerprints"
  ],
  "summary": "Згенерувати новий відбиток (ОС хоста)",
  "description": "Повертає повністю унікалізований відбиток для **хостової**\nопераційної системи без збереження. Еквівалентно виклику\n`/fingerprint/new/{platform}` з платформою хоста.\n",
  "responses": {
    "200": {
      "description": "Унікалізований, не збережений відбиток.",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/FingerprintEnvelope"
          }
        }
      }
    },
    "401": {
      "$ref": "#/components/responses/Unauthorized"
    },
    "404": {
      "description": "Бібліотека відбитків порожня.",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    }
  }
}
```

## Згенерувати новий відбиток для заданої платформи

`GET /fingerprint/new/{platform}`

```json
{
  "tags": [
    "Fingerprints"
  ],
  "summary": "Згенерувати новий відбиток для заданої платформи",
  "description": "Вибирає випадковий відбиток з бібліотеки, що відповідає `platform`,\nпотім унікалізує його: нова `platform_version` для Sec-CH-UA,\n`hardware_concurrency`/`device_memory` з урахуванням хоста (не перевищують\nреальні значення машини), екран, обрізаний під реальний дисплей.\nПовертається без збереження; передайте як `fingerprint` в ендпоінт створення.\n",
  "parameters": [
    {
      "name": "platform",
      "in": "path",
      "required": true,
      "description": "Регістронезалежно; приймаються псевдоніми `win`/`osx`/`darwin`.",
      "schema": {
        "type": "string",
        "enum": [
          "Windows",
          "macOS",
          "Linux"
        ]
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Унікалізований, не збережений відбиток.",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/FingerprintEnvelope"
          }
        }
      }
    },
    "401": {
      "$ref": "#/components/responses/Unauthorized"
    },
    "404": {
      "description": "Підходящий відбиток не знайдено або бібліотека порожня.",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    }
  }
}
```

## Список відбитків бібліотеки

`GET /fingerprints`

```json
{
  "tags": [
    "Fingerprints"
  ],
  "summary": "Список відбитків бібліотеки",
  "description": "Бібліотека відбитків на диску (GPU-пресети), що постачається/імпортується лаунчером.",
  "responses": {
    "200": {
      "description": "Записи бібліотеки.",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LibraryEntry"
            }
          }
        }
      }
    },
    "401": {
      "$ref": "#/components/responses/Unauthorized"
    }
  }
}
```