Snabbstart

1. Skaffa en API-nyckel

Registrera dig i Cerrtify-dashboarden och skapa en API-nyckel för sandbox-miljön. Nycklar har formatet cert_<prefix>_<secret> och är bundna till en miljö — sandbox-nycklar kan inte anropa produktion och vice versa.

2. Välj en bas-URL

Växlaren uppe till höger styr vilken miljö kodexemplen på den här sidan pekar mot:

• Sandbox → https://sandbox-api.cerrtify.com
• Produktion → https://api.cerrtify.com

Vald just nu: https://sandbox-api.cerrtify.com

3. Starta en BankID-auth-order

curl -X POST https://sandbox-api.cerrtify.com/service/bankid/auth \
  -H "X-API-Key: cert_..." \
  -H "Content-Type: application/json" \
  -d '{"endUserIp":"192.168.0.1"}'

Du får tillbaka en orderRef, plus autoStartToken, qrStartToken och qrStartSecret för QR-rendering.

4. Polla tills klart

curl -X POST https://sandbox-api.cerrtify.com/service/bankid/collect \
  -H "X-API-Key: cert_..." \
  -H "Content-Type: application/json" \
  -d '{"orderRef":"<from-step-3>"}'

Polla ungefär varannan sekund tills status är complete eller failed. Hela flödet (inklusive QR-rendering och avbrytning) beskrivs i BankID-auth-guiden.

Nästa steg

• Läs Autentisering om nyckelrotation, scopes och CORS.
• Bläddra i API-referensen.
• Testa guiden för företagsuppslag eller guiden för persondatasökning.