Activate a device

Portée requiselicense_keys:writeLa clé API doit porter cette portée, sinon Kivoo répond 403 insufficient_scope.
POST/v1/license-keys/activate

Give a device of the buyer a place on an active key. The same device again keeps its place and takes no other, so you may activate at every start. Kivoo keeps the IP address and the User-Agent of the call. 600 requests a minute per API key, apart from the other routes.

Autorisation

apiKey
AuthorizationBearer <clé API>

An API key of the store, kv_live_…

Dans: header

Corps de la requête

application/json

Définitions TypeScript

Utilise le type request body en TypeScript.

Corps de la réponse

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.kivoo.africa/v1/license-keys/activate" \  -H "Authorization: Bearer kv_live_EXAMPLE0000000000000000000000000000000000" \  -H "Content-Type: application/json" \  -d '{    "key": "BAU-XKCD-92HF-LM7P-Q4RT",    "deviceIdentifier": "mac-7f3a9c"  }'
{  "id": "1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",  "keyHint": "BAU-…-Q4RT",  "status": "active",  "isActive": true,  "issuedAt": "2026-10-15T09:12:00.000Z",  "expiresAt": "2026-11-14T09:12:00.000Z",  "revokedAt": null,  "activations": {    "count": 1,    "max": 1,    "remaining": 0  },  "product": {    "id": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b",    "title": "Bauhaus Pro"  },  "customer": {    "id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",    "email": "awa@example.com"  },  "order": {    "id": "4d5e6f7a-8b9c-4d0e-8f2a-3b4c5d6e7f8a",    "reference": "KV-7F3K9QA2"  },  "checkout": {    "id": "8a7b6c5d-4e3f-4a1b-9c0d-1e2f3a4b5c6d",    "externalReference": "42",    "metadata": {      "plan": "pro"    }  },  "key": "BAU-XKCD-92HF-LM7P-Q4RT"}