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

# Lizenzschlüssel

> Stellen Sie Lizenzschlüssel für Kunden mit HWID-Bindung aus und verwalten Sie sie.

## Schlüsseltypen

| `key_type` | Verhalten |
| :- | :- |
| `time_limited` | Gültig für `days` Tage. Standard. |
| `hour_limited` | `days` wird als Stunden interpretiert. |
| `single_use` | Kann einmal aktiviert werden. |
| `multi_use` | Kann bis zu `max_uses` Mal aktiviert werden. |
| `time_restricted` | Nur innerhalb eines festgelegten Zeitfensters gültig. |

## Schlüssel erstellen

```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)

Bindet den Schlüssel an den ersten Rechner, der ihn aktiviert.

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

Bei `true` beginnt der Countdown sofort. Bei `false` beginnt er bei der ersten Verwendung.

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

Erzeugen Sie bis zu 100 Schlüssel in einem Aufruf.

## Schlüssel verwalten

> [accordion] HWID zurücksetzen
>
> Ermöglichen Sie einem Kunden den Wechsel auf einen neuen PC: `POST /keys/{id}/reset-hwid`.

> [accordion] Einfrieren und auftauen
>
> Pausieren Sie den Countdown während einer Ausfallzeit mit `POST /keys/{id}/freeze`. Setzen Sie ihn mit `DELETE /keys/{id}/freeze` fort.

> [accordion] Verlängern
>
> Fügen Sie mit `POST /keys/{id}/add-time` und `{ "days": 7 }` Tage hinzu.

> [accordion] Sperren und entsperren
>
> Widerrufen Sie mit `POST /keys/{id}/ban` und einem `reason`. Stellen Sie mit `POST /keys/{id}/unban` wieder her.

## Ablaufende Schlüssel finden

Listen Sie Schlüssel auf, die in den nächsten sieben Tagen ablaufen, um Erinnerungen zur Verlängerung zu senden:

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