API til certificerede data

API med certificerede køretøjsdata til udviklere

Integrér certificerede, revisionsklare data om bilhistorik i din applikation via vores RESTful API. Hentet fra over 900 officielle registre og 1 mia.+ efterprøvede registreringer i 45+ lande, understøttet af en SLA på 99,95 % oppetid.

https://api.autocertif.com/v1

Kom i gang Se endpoints

Kom hurtigt i gang

Hent din API-nøgle

Opret en certificeret erhvervskonto, og generér din API-nøgle fra dashboardet. Sandbox-nøgler er tilgængelige til compliance-test uden forbrug af forespørgsler.

Foretag dit første kald

Godkend med din API-nøgle og din certifikatnøgle, og send så din første forespørgsel til et vilkårligt endpoint. Start med endpointet for køretøjets identitet og få et øjeblikkeligt svar med kildeangivelse.

Få resultaterne

Modtag struktureret JSON med certificerede køretøjsdata, kildeangivelse og et kontroltidsstempel på hvert felt. Behandl, vis eller arkivér resultaterne efter behov.

Godkendelse

Hver API-forespørgsel godkendes med to nøgler: et Bearer-token i Authorization-headeren og din X-Certificate-Key-header. Nøgler udstedes, udskiftes og spærres fra dit certificerede erhvervsdashboard med fuld adgangslogning til compliance.

Eksempel på forespørgsel

curl -X GET https://api.autocertif.com/v1/vehicles/WBA3A5G59DNP26082/identity \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Certificate-Key: YOUR_CERTIFICATE_KEY" \
  -H "Content-Type: application/json"

Pas godt på dine nøgler! Udstil aldrig din API-nøgle eller X-Certificate-Key i kode på klientsiden. Gem dem i miljøvariabler, og send kaldene gennem en proxy på serversiden, så dine nøgler og dit revisionsspor forbliver sikre.

Endpoints

API'et til certificerede data stiller fem centrale endpoints til rådighed: bestil en certificeret rapport, hent et certifikat, følg certificeringens status, kør certificeringer i store mængder, og slå en VIN-identitet op. Hvert certifikat bærer et forfalskningssikkert segl, kildeangivelse og et certified_at-tidsstempel.

POST/v1/certificates

Bestil certifikat

Bestil en certificeret køretøjsrapport ud fra et VIN eller en nummerplade. Hvert datapunkt spores til sin officielle kilde, forsegles og tidsstemples.

Parametre

Navn	Type	Påkrævet	Beskrivelse
`vin`	string	Betinget	Køretøjets identifikationsnummer på 17 tegn. Påkrævet, medmindre license_plate angives.
`license_plate`	string	Betinget	Nummerplade. Påkrævet, medmindre vin angives.
`country`	string	Ja	ISO-landekode for indregistreringen, for eksempel FR
`depth`	string	Nej	Certificeringens dybde: standard (standardvalg) eller full

Eksempel på forespørgsel

curl -X POST https://api.autocertif.com/v1/certificates \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Certificate-Key: YOUR_CERTIFICATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vin": "WBA3A5G59DNP26082", "country": "FR", "depth": "full"}'

GET/v1/certificates/{certificate_id}

Hent certifikat

Hent et tidligere udstedt certifikat ud fra dets id, inklusive segl, kontroller og pålidelighedsscore.

Parametre

Navn	Type	Påkrævet	Beskrivelse
`certificate_id`	string	Ja	Certifikatets id, som blev returneret, da rapporten blev bestilt (stiparameter)

Eksempel på forespørgsel

curl -X GET https://api.autocertif.com/v1/certificates/cert_8f2a91 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Certificate-Key: YOUR_CERTIFICATE_KEY"

GET/v1/certificates/{certificate_id}/status

Certifikatets status

Tjek et certifikats behandlings- og certificeringsstatus, mens dets officielle kilder kontrolleres.

Parametre

Navn	Type	Påkrævet	Beskrivelse
`certificate_id`	string	Ja	Id på det certifikat, der skal undersøges (stiparameter)

Eksempel på forespørgsel

curl -X GET https://api.autocertif.com/v1/certificates/cert_8f2a91/status \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Certificate-Key: YOUR_CERTIFICATE_KEY"

POST/v1/certificates/bulk

Certifikater i store mængder

Send en samlet gruppe af id'er til certificering i ét kald. Hvert certifikat forsegles for sig og kan hentes eller følges enkeltvis.

Parametre

Navn	Type	Påkrævet	Beskrivelse
`identifiers`	array	Ja	Liste af VIN- eller nummerpladestrenge (maks. 100 pr. forespørgsel)
`country`	string	Ja	ISO-landekode, der gælder for hele gruppen, for eksempel FR
`depth`	string	Nej	Certificeringsdybde, der gælder for hvert element: standard (standardvalg) eller full

Eksempel på forespørgsel

curl -X POST https://api.autocertif.com/v1/certificates/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Certificate-Key: YOUR_CERTIFICATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"identifiers": ["WBA3A5G59DNP26082", "WVWZZZ3CZWE123456"], "country": "FR", "depth": "full"}'

GET/v1/vehicles/{vin}/identity

Køretøjets identitet

Slå et VIN op mod officielle producentregistre, og få mærke, model, årgang og certificerede specifikationer uden at udstede et fuldt certifikat.

Parametre

Navn	Type	Påkrævet	Beskrivelse
`vin`	string	Ja	Køretøjets identifikationsnummer på 17 tegn (stiparameter)
`include_specs`	boolean	Nej	Medtag de fulde certificerede tekniske specifikationer

Eksempel på forespørgsel

curl -X GET https://api.autocertif.com/v1/vehicles/WBA3A5G59DNP26082/identity \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Certificate-Key: YOUR_CERTIFICATE_KEY"

Svarformat

Hvert certifikat returneres som et ensartet JSON-objekt: et unikt certificate_id, et kontrolsegl, det afkodede køretøj, de certificerede kontroller, en pålidelighedsscore og metadata, der dokumenterer forespørgslens kontekst.

JSON-svar

{
  "certificate_id": "cert_8f2a91",
  "vin": "WBA3A5G59DNP26082",
  "certified_at": "2026-03-12T10:04:00Z",
  "seal": {
    "id": "seal_3kf9",
    "valid": true
  },
  "vehicle": {
    "make": "BMW",
    "model": "320d",
    "year": 2019
  },
  "checks": {
    "mileage": {
      "value": 142350,
      "unit": "km",
      "verified": true
    },
    "accidents": 0,
    "theft": "none",
    "title": "clean"
  },
  "official_sources": 8200,
  "confidence_score": 9.1,
  "meta": {
    "country": "FR",
    "depth": "full"
  }
}

Felter i svaret

certificate_idUnikt id på det udstedte certifikat med præfikset cert_

vinDet certificerede identifikationsnummer på køretøjet

certified_atISO 8601-tidsstempel for, hvornår certifikatet blev forseglet

sealForfalskningssikkert kontrolsegl med sit id (præfikset seal_) og feltet valid

vehicleKøretøjets afkodede identitet: mærke, model og årgang

checks.mileageAflæst kilometerstand med enhed og certificeret kontrolstatus

checks.accidentsAntal certificerede ulykkesregistreringer

checks.theftTyveristatus kontrolleret mod officielle politidatabaser: none eller flagged

checks.titlePapirstatus certificeret mod det officielle register: clean eller branded

official_sourcesSamlet antal officielle datakilder, der er krydstjekket til dette certifikat

confidence_scoreCertificeringens pålidelighed på en skala fra 0 til 10

metaForespørgslens kontekst: indregistreringsland og certificeringsdybde

Fejlhåndtering

API'et bruger almindelige HTTP-statuskoder. Hver fejl returnerer en beskrivende meddelelse og et detail-felt med et forespørgsels-id, der understøtter fejlsøgning og revision.

Kode	Meddelelse	Beskrivelse
400	Bad Request	Forespørgslens body eller parametre er forkert udformet eller mangler påkrævede felter.
401	Unauthorized	API-nøglen mangler, er ugyldig eller er blevet spærret.
403	Forbidden	API-nøglen har ikke adgang til dette endpoint eller denne ressource.
404	Not Found	Den ønskede ressource (certifikat, køretøj) blev ikke fundet.
429	Too Many Requests	Forespørgselsgrænsen er overskredet. Se X-Certificate-RateLimit-headerne, og prøv igen efter nulstillingen.
500	Server Error	Der opstod en intern fejl. Prøv forespørgslen igen, eller kontakt supporten, hvis fejlen fortsætter.

Eksempel på fejlsvar

{
  "status": "error",
  "error": {
    "code": 401,
    "message": "Unauthorized",
    "detail": "The provided API key is invalid or has expired."
  }
}

Forespørgselsgrænser

API-forespørgsler er begrænset efter abonnementstrin, som hver er dækket af en kontraktlig SLA. Det aktuelle forbrug af grænsen fremgår af svar-headerne i hvert kald.

Starter

Forespørgsler/min.

Forespørgsler/dag

1,000

Samtidige

Growth

Forespørgsler/min.

300

Forespørgsler/dag

10,000

Samtidige

Enterprise

Forespørgsler/min.

1,000+

Forespørgsler/dag

Ubegrænset

Samtidige

100+

Headere for forespørgselsgrænser

Hvert API-svar indeholder headere, så du kan følge forbruget i forhold til din SLA i realtid.

X-Certificate-RateLimit-Limit, maksimalt tilladte forespørgsler pr. periode
X-Certificate-RateLimit-Remaining, resterende forespørgsler i den aktuelle periode
X-Certificate-RateLimit-Reset, Unix-tidsstempel for, hvornår grænsen nulstilles

Webhooks

Modtag signerede notifikationer i realtid, når et certifikat udstedes, eller når der sker vigtige hændelser på kontoen. Opsæt og kontrollér webhook-endpoints fra dit dashboard.

Understøttede hændelser

certificate.issued, et certifikat blev forseglet og udstedt korrekt
certificate.failed, certificeringen kunne ikke gennemføres
bulk.completed, alle certifikater i en gruppe er forseglet
bulk.partial, nogle certifikater i en gruppe er forseglet
subscription.usage, forespørgselsgrænsen eller kvoten nærmer sig

Sikkerhed for webhooks

Hvert webhook-payload signeres med HMAC-SHA256 ud fra din webhook-hemmelighed. Kontrollér X-Certificate-Signature-headeren for at bekræfte ægthed og integritet, før du behandler det.

Eksempel på webhook-payload

{
  "event": "certificate.issued",
  "timestamp": "2026-03-12T10:04:00Z",
  "data": {
    "certificate_id": "cert_8f2a91",
    "vin": "WBA3A5G59DNP26082",
    "status": "certified",
    "seal": {
      "id": "seal_3kf9",
      "valid": true
    },
    "certificate_url": "https://api.autocertif.com/v1/certificates/cert_8f2a91"
  }
}

Klar til at bygge på certificerede data?

Opret din certificerede udviklerkonto, og begynd allerede i dag at integrere officielle køretøjsdata med SLA i dine applikationer.

Hent din API-nøgle Kontakt salg