Mobile-ID Quantum Safe
Open Demo Lab

REFERENCE API CONTRACT

QuantumSafe QKD Bridge
Research / Partner Pilot

Reference ETSI QKD 014-style and key-lease API contract published.

RESOURCE MODEL

Named endpoints aligned to the product workflow.

MethodEndpointPurpose
GET/v1/key-poolsRead pool health and site status
POST/v1/keys/leaseLease a policy-approved key identifier
POST/v1/keys/{keyId}/consumeRecord one-time key consumption
POST/v1/failoverSwitch to approved alternate site or fallback policy

COMMON HEADERS

Authorization: Bearer <token>
X-Correlation-Id: <uuid>
Idempotency-Key: <uuid>
X-Request-Timestamp: <RFC3339>
Content-Type: application/json

REQUEST ENVELOPE

{
  "profileId": "QS-QB-2026.07",
  "requestId": "5fda47cb-55c8-45a8-81a6-2dd1d1938b47",
  "mode": "controlled-evaluation",
  "evidenceRequired": true
}

ERROR MODEL

  • 400 — Invalid schema or unsupported profile
  • 401/403 — Authentication or policy denial
  • 409 — Idempotency or state conflict
  • 422 — Evidence or compatibility requirement not met
  • 503 — Protected dependency unavailable; fail-closed unless approved otherwise

VERSIONING

  • Major version in path for incompatible change.
  • Profile ID and evidence schema are versioned independently.
  • Deprecation requires notice, replacement path and project review.
  • Exact authentication and request-signature policy is deployment-specific.

IMPLEMENTATION PATH

QuantumSafe QKD Bridge

Validate the API contract together with the test corpus and readiness passport.

Test corpusReadiness passport