Asynkrona jobb

De flesta BankID- och Persondata-endpoints accepterar ?async=true (eller headern X-Async: true). I stället för att köra uppströmsanropet direkt köar Cerrtify det och svarar omedelbart.

Köa ett jobb

POST /service/bankid/auth?async=true
X-API-Key: cert_...
Content-Type: application/json

{ "endUserIp": "192.168.0.1" }

Svar:

{
  "job_id": "job_01H8X...",
  "status": "queued",
  "poll": "/service/jobs/job_01H8X..."
}

HTTP-statusen är 202 Accepted.

Polla status

GET /service/jobs/job_01H8X...
X-API-Key: cert_...

Svar medan jobbet pågår:

{ "id": "job_01H8X...", "type": "bankid:auth", "status": "running", "attempts": 1, "max_attempts": 3 }

Svar när jobbet nått ett slutläge:

{
  "id": "job_01H8X...",
  "type": "bankid:auth",
  "status": "done",
  "result": { "orderRef": "...", "qrStartToken": "...", "qrStartSecret": "..." },
  "attempts": 1,
  "enqueued_at": "2026-07-01T08:31:02Z",
  "finished_at": "2026-07-01T08:31:14Z",
  "expires_at": "2026-07-08T08:31:02Z"
}

status är ett av queued, running, done, failed, cancelled. Vid failed, titta på error_code och error_message. Jobb och deras resultat rensas efter expires_at (7 dagar).

Vilka endpoints stöder async?

Alla BankID:s order-endpoints (/auth, /sign, /collect, /cancel, /phone/auth, /phone/sign) samt Persondatas sök-endpoints med rå XML. Betal-endpoints (/payment, /other/payment) och .json-varianterna av Persondata är enbart synkrona.

När ska du använda det?

• Anroparen kan inte vänta ut hela uppströmslatensen (t.ex. mobilklienter på dåliga nätverk).
• Du behöver beständiga omförsök vid tillfälliga uppströmsfel — Cerrtify gör automatiskt om anrop som fallerar mot uppströmstjänsten.
• Du vill ha ett enda job_id som är säkert att visa i ditt UI och som går att återuppta efter en sidomladdning.