License keys

Key types

`key_type`	Behavior
`time_limited`	Valid for `days` days. Default.
`hour_limited`	`days` is read as hours.
`single_use`	Can be activated once.
`multi_use`	Can be activated up to `max_uses` times.
`time_restricted`	Valid only inside a set time window.

Create keys

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"
  }'

boolean

default:"true"

Locks the key to the first machine that activates it.

boolean

default:"false"

When true, the countdown starts now. When false, it starts on first use.

integer

default:"1"

Generate up to 100 keys in one call.

Manage a key

Reset HWID

Let a customer move to a new PC: POST /keys/{id}/reset-hwid.

Freeze and unfreeze

Pause the countdown during downtime with POST /keys/{id}/freeze. Resume with DELETE /keys/{id}/freeze.

Extend

Add days with POST /keys/{id}/add-time and { "days": 7 }.

Ban and unban

Revoke with POST /keys/{id}/ban and a reason. Restore with POST /keys/{id}/unban.

Find expiring keys

List keys that expire in the next seven days to send renewal reminders:

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

Guides

Endpoints

Key types

Create keys

Manage a key

Find expiring keys

​Key types

​Create keys

​Manage a key

​Find expiring keys

Key types

Create keys

Manage a key

Find expiring keys