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

# Claves de licencia

> Emita y gestione claves de licencia de clientes con vinculación por HWID.

## Tipos de clave

| `key_type` | Comportamiento |
| :- | :- |
| `time_limited` | Válida durante `days` días. Valor por defecto. |
| `hour_limited` | `days` se interpreta como horas. |
| `single_use` | Se puede activar una sola vez. |
| `multi_use` | Se puede activar hasta `max_uses` veces. |
| `time_restricted` | Válida solo dentro de una franja horaria definida. |

## Crear claves

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

Vincula la clave al primer equipo que la activa.

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

Si es `true`, la cuenta regresiva empieza ahora. Si es `false`, empieza con el primer uso.

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

Genere hasta 100 claves en una sola llamada.

## Gestionar una clave

> [accordion] Restablecer el HWID
>
> Permita que un cliente pase a un PC nuevo: `POST /keys/{id}/reset-hwid`.

> [accordion] Congelar y descongelar
>
> Pause la cuenta regresiva durante una interrupción del servicio con `POST /keys/{id}/freeze`. Reanude con `DELETE /keys/{id}/freeze`.

> [accordion] Extender
>
> Agregue días con `POST /keys/{id}/add-time` y `{ "days": 7 }`.

> [accordion] Vetar y levantar el veto
>
> Revoque con `POST /keys/{id}/ban` y un `reason`. Restaure con `POST /keys/{id}/unban`.

## Encontrar claves a punto de caducar

Liste las claves que caducan en los próximos siete días para enviar recordatorios de renovación:

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