> ## Documentation Index
> Fetch the complete documentation index at: https://developers.papelship.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ліцензійні ключі

> Видавайте та керуйте ліцензійними ключами клієнтів із прив'язкою до HWID.

## Типи ключів

| `key_type` | Поведінка |
| :- | :- |
| `time_limited` | Дійсний протягом `days` днів. За замовчуванням. |
| `hour_limited` | `days` тлумачиться як години. |
| `single_use` | Можна активувати один раз. |
| `multi_use` | Можна активувати до `max_uses` разів. |
| `time_restricted` | Дійсний лише в межах заданого часового вікна. |

## Створення ключів

```bash theme={"system"}
curl -X POST https://app.papelship.com/api/qpapel/v1/keys \
  -H "Authorization: Bearer pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": 101,
    "days": 30,
    "key_type": "time_limited",
    "bind_hwid": true,
    "auto_start": false,
    "amount": 1,
    "note": "Order #1042"
  }'
```

**bind\_hwid** `boolean` (default: true)

Прив'язує ключ до першого комп'ютера, на якому його активовано.

**auto\_start** `boolean` (default: false)

Якщо `true`, відлік починається негайно. Якщо `false`, він починається під час першого використання.

**amount** `integer` (default: 1)

Генерує до 100 ключів за один виклик.

## Керування ключем

> [accordion] Скидання HWID
>
> Дозвольте клієнту перейти на новий ПК: `POST /keys/{id}/reset-hwid`.

> [accordion] Замороження та розмороження
>
> Призупініть відлік на час простою через `POST /keys/{id}/freeze`. Відновіть через `DELETE /keys/{id}/freeze`.

> [accordion] Подовження
>
> Додайте дні через `POST /keys/{id}/add-time` із `{ "days": 7 }`.

> [accordion] Блокування та розблокування
>
> Відкличте через `POST /keys/{id}/ban` із `reason`. Відновіть через `POST /keys/{id}/unban`.

## Пошук ключів, термін дії яких спливає

Отримайте список ключів, термін дії яких спливає протягом наступних семи днів, щоб надіслати нагадування про поновлення:

```bash theme={"system"}
curl "https://app.papelship.com/api/qpapel/v1/keys?expiresInDays=7&sortBy=end_time&sortOrder=ASC" \
  -H "Authorization: Bearer pk_live_your_key"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.