Checkin Floating Session

Release a floating license session when a user closes the application.

Authentication required: Bearer Token in Authorization header.

Parameters

Idempotency-Key

string (header)

Client-generated unique key making a mutating request idempotent. Replaying a request with the same key returns the original result instead of duplicating side effects. Optional on POST/PUT/PATCH/DELETE.

e.g. <IDEMPOTENCY-KEY>

Request Body (application/json)

productIdrequired

string

licenseKeyrequired

string

sessionIdrequired

string

The 22-character unique session ID

timestamprequired

string | integer

The cryptographic nonce (nextNonce) received from the previous checkout or heartbeat response. Despite the field name, current server code requires nonce equality and does not accept arbitrary client timestamps.

signaturerequired

string

HMAC-SHA256 signature generated using the sessionSecret over the payload 'sessionId:nonce'.

Responses

200Session checked in successfully

Response Body (200)

code

integer

message

string

Request Example

curl -X POST "https://api.keymint.dev/key/checkin" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "productId": "string",
  "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX",
  "sessionId": "abc123sessionid22chars",
  "timestamp": "string",
  "signature": "string"
}'

Response (200 OK)

{
  "code": 0,
  "message": "string"
}