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

# Clés de licence

> Émettez et gérez les clés de licence de vos clients avec liaison HWID.

## Types de clés

| `key_type` | Comportement |
| :- | :- |
| `time_limited` | Valide pendant `days` jours. Par défaut. |
| `hour_limited` | `days` est interprété en heures. |
| `single_use` | Peut être activée une seule fois. |
| `multi_use` | Peut être activée jusqu'à `max_uses` fois. |
| `time_restricted` | Valide uniquement dans une plage horaire définie. |

## Créer des clés

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

Verrouille la clé sur la première machine qui l'active.

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

Si `true`, le décompte démarre immédiatement. Si `false`, il démarre à la première utilisation.

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

Générez jusqu'à 100 clés en un seul appel.

## Gérer une clé

> [accordion] Réinitialiser le HWID
>
> Permettez à un client de passer sur un nouveau PC : `POST /keys/{id}/reset-hwid`.

> [accordion] Geler et dégeler
>
> Mettez le décompte en pause pendant une interruption de service avec `POST /keys/{id}/freeze`. Reprenez avec `DELETE /keys/{id}/freeze`.

> [accordion] Prolonger
>
> Ajoutez des jours avec `POST /keys/{id}/add-time` et `{ "days": 7 }`.

> [accordion] Bannir et débannir
>
> Révoquez avec `POST /keys/{id}/ban` et un `reason`. Rétablissez avec `POST /keys/{id}/unban`.

## Trouver les clés qui expirent bientôt

Listez les clés qui expirent dans les sept prochains jours pour envoyer des rappels de renouvellement :

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