# 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"
    }
  }
}
```