Fullständig API-dokumentation
Endpoints, autentisering, exempel på anrop och svar, felkoder och miljöer finns på certidrive.apidocumentation.com.
För att använda API:et behöver ni ett aktivt CertiDrive-konto, en API-nyckel och, för registreringar, att företaget är godkänt hos Transportstyrelsen.
API:er
Publikt registrerings-API
Basadress: https://api.certidrive.se
GET /v1/registrationslistar registreringar. Parametrar:limit(högst 200),offset,statusochvin.GET /v1/registrations/{id}hämtar en registrering.POST /v1/registrationsskapar en intern registreringspost med de tillåtna fältenvin,owner,reg_numberochdata.
ERP eCoC-API
Basadress: https://api.certidrive.se
POST /v1/ecoc-registrationsstartar eCoC-kedjan. HeadernIdempotency-Keykrävs.GET /v1/ecoc-registrations/{job_id}hämtar jobbstatus.GET /v1/ecoc-registrations?external_reference=<er referens>hittar jobb via ERP:ets egen referens.POST /v1/ecoc-registrations/{job_id}/retryåterupptar ett stoppat jobb.POST /v1/ecoc-registrations/{job_id}/resolveregistrerar vad en kontroll i eReKo visade när svaret från Transportstyrelsen uteblev.GET /v1/ecoc-registrations/{job_id}/ecochämtar den eCoC-fil som RDW godkände.POST /v1/ecoc-registrations/validatekontrollerar ett anrop utan att något sparas eller skickas.GET /v1/template-fieldslistar mallens värden somecoc_fieldskan ersätta, med typ och tillåtna värden från IVI-XSD:n.GET /v1/profileslistar arbetsytans registreringsprofiler.GET /v1/readinessvisar om certifikat, mall, profiler och webhook är klara i nyckelns miljö.GET /v1/openapi.jsonär en maskinläsbar beskrivning av hela ERP-API:t (OpenAPI 3.1). Den kräver ingen nyckel och kan importeras i till exempel Postman.
Autentisering
Skicka API-nyckeln i x-api-key. Det publika registrerings-API:t accepterar även Authorization: Bearer <nyckel>. Nyckeln identifierar både arbetsyta och miljö och begränsas av valda scopes.
Viktigt att veta
POST /v1/registrations skapar bara en intern post. Det skickar inte uppgifterna till Transportstyrelsen. Använd ERP eCoC-API:t eller ett arbetsflöde i CertiDrive för myndighetssändning.
Scopes stock:* och registrations:status kan väljas i nyckelvyn, men den aktuella publika API-funktionen exponerar bara registreringsrutterna ovan. Bygg inte en integration mot en route som inte finns dokumenterad och verifierad.
