Developer platform · Public beta

Getting started

Create a project, keep its API key on your server, and make your first request.

Base URL and beta status

Use the origin that hosts KonfigurátorSPZ followed by /api/v1. The developer platform is a public beta and can be suspended or rate-limited while capacity is measured.

Never place a secret API key in browser JavaScript, an iframe URL, a postMessage payload, source control, or logs.

Authentication

Server requests use Authorization: Bearer <secret-project-key>. API keys are shown once and are scoped to one project.

Browser code must first obtain an origin-bound, short-lived browser session from your own server. Registered iframes receive that session in the Authorization header; public iframes need no credential.

curl -X POST "$BASE_URL/api/v1/plates/verify" \
  -H "Authorization: Bearer $SPZ_API_KEY" \
  -H "Idempotency-Key: verify-demo-001" \
  -H "Content-Type: application/json" \
  --data '{"text":"ABC12345","shape":"standard"}'

Administrative approval

Verification and availability are advisory. A syntactically valid or not-found result does not reserve a registration mark and does not replace administrative approval by the competent Czech authority.