> ## 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.