Integration API — cURL Examples

Last updated: Phase 8.5

Validate a License

curl -X POST https://api.validonx.com/api/v1/integration/licenses/VX-ACME-abc123/validate \
  -H "X-API-Key: vx_your_api_key_here" \
  -H "Content-Type: application/json" \
  -H "X-Request-ID: $(uuidgen)"

Response:

{
  "data": {
    "valid": true,
    "license": {
      "id": "uuid",
      "key": "VX-ACME-abc123",
      "type": "subscription",
      "status": "active",
      "expires_at": "2027-03-30T00:00:00+00:00",
      "entitlements": { "plan": "pro" }
    }
  },
  "meta": { "request_id": "uuid", "api_version": "1" }
}

Create an Activation

curl -X POST https://api.validonx.com/api/v1/integration/activations \
  -H "X-API-Key: vx_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "VX-ACME-abc123",
    "instance_id": "server-prod-01",
    "device_fingerprint": "sha256-device-hash",
    "metadata": {"os": "linux", "version": "2.1.0"}
  }'

Validate an Activation

curl -X POST https://api.validonx.com/api/v1/integration/activations/123/validate \
  -H "X-API-Key: vx_your_api_key_here" \
  -H "Content-Type: application/json"

Check Entitlements

curl -X POST https://api.validonx.com/api/v1/integration/entitlements/check \
  -H "X-API-Key: vx_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "VX-ACME-abc123",
    "features": ["activations.max", "features.export"]
  }'

Record Usage

curl -X POST https://api.validonx.com/api/v1/integration/usage/record \
  -H "X-API-Key: vx_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "VX-ACME-abc123",
    "metric": "api.calls",
    "quantity": 100
  }'