Idempotens

För endpoints som köar asynkrona jobb (alla /service/*-anrop med ?async=true) kan du skicka en Idempotency-Key-header för att göra omförsök säkra.

POST /service/bankid/auth?async=true
X-API-Key: cert_...
Idempotency-Key: 6c1f2cdc-3b3e-4f1a-8e91-1a2b3c4d5e6f
Content-Type: application/json

Semantik

• Samma nyckel, samma organisation → returnerar det ursprungliga jobbets job_id och poll-URL. Inget duplicerat jobb köas. Requestens body jämförs inte — det ursprungliga jobbet vinner, så återanvänd aldrig en nyckel för en annan request.
• Nyckel saknas → anropet behandlas som nytt, utan skydd mot dubbletter.
• Jobb (och deras idempotensnycklar) sparas i 7 dagar, därefter kan nyckeln användas igen.

Att välja nycklar

Använd ett UUIDv4 per logisk request (t.ex. ett per checkout-session). Återanvänd inte nycklar mellan orelaterade operationer.

Scope

Nyckeln är avgränsad till din API-nyckels organisation, så två olika organisationer kan använda samma nyckelvärde utan kollision.