API for sertifiserte data

API for sertifiserte kjøretøydata, laget for utviklere

Integrer sertifiserte, revisjonsklare kjøretøydata i applikasjonen din via vårt RESTful API. Hentet fra over 900 offisielle registre og 1 mrd.+ kontrollerte oppføringer i 45+ land, med en SLA på 99,95 % oppetid.

https://api.autocertif.com/v1

Kom i gang Se endepunktene

Kom i gang

Hent API-nøkkelen din

Registrer en sertifisert bedriftskonto og generer API-nøkkelen din fra dashbordet. Sandkassenøkler er tilgjengelige for testing av samsvar, uten forbrukskostnad.

Gjør ditt første kall

Autentiser med API-nøkkelen og sertifikatnøkkelen din, og send den første forespørselen til et endepunkt. Start med endepunktet for kjøretøyidentitet for et umiddelbart svar med kildesporing.

Hent resultatene

Motta strukturert JSON med sertifiserte kjøretøydata, kildehenvisning og et kontrolltidsstempel på hvert felt. Tolk, vis eller arkiver resultatene slik du trenger.

Autentisering

Hver API-forespørsel autentiseres med to nøkler: et Bearer-token i Authorization-headeren og din X-Certificate-Key-header. Nøkler utstedes, byttes ut og trekkes tilbake fra det sertifiserte bedriftsdashbordet ditt, med full tilgangslogging for samsvarskrav.

Eksempelforespørsel

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"

Ta godt vare på nøklene dine! Legg aldri API-nøkkelen eller X-Certificate-Key ut i kode som kjører i nettleseren. Lagre dem i miljøvariabler og send kallene gjennom en proxy på serversiden, slik at nøklene og revisjonssporet forblir sikre.

Endepunkter

API-et for sertifiserte data har fem sentrale endepunkter: be om en sertifisert rapport, hente et sertifikat, følge sertifiseringsstatus, kjøre sertifisering i bulk og slå opp en VIN-identitet. Hvert sertifikat har et forfalskningssikret segl, kildehenvisning og et certified_at-tidsstempel.

POST/v1/certificates

Be om sertifikat

Be om en sertifisert kjøretøyrapport ut fra en VIN eller et registreringsnummer. Hvert datapunkt spores til sin offisielle kilde, forsegles og tidsstemples.

Parametere

Navn	Type	Påkrevd	Beskrivelse
`vin`	string	Betinget	Kjøretøyets identifikasjonsnummer på 17 tegn. Påkrevd med mindre license_plate er oppgitt.
`license_plate`	string	Betinget	Registreringsnummer. Påkrevd med mindre vin er oppgitt.
`country`	string	Ja	ISO-landkode for registreringen, for eksempel FR
`depth`	string	Nei	Sertifiseringsdybde: standard (standardvalg) eller full

Eksempelforespørsel

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 sertifikat

Hent et tidligere utstedt sertifikat via identifikatoren, inkludert seglet, kontrollene og tillitsscoren.

Parametere

Navn	Type	Påkrevd	Beskrivelse
`certificate_id`	string	Ja	Sertifikatidentifikatoren som ble returnert da rapporten ble bestilt (stiparameter)

Eksempelforespørsel

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

Sertifikatstatus

Sjekk behandlings- og sertifiseringsstatusen for et sertifikat mens de offisielle kildene kontrolleres.

Parametere

Navn	Type	Påkrevd	Beskrivelse
`certificate_id`	string	Ja	Sertifikatidentifikatoren som skal undersøkes (stiparameter)

Eksempelforespørsel

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

Sertifikater i bulk

Send inn en gruppe identifikatorer for sertifisering i ett enkelt kall. Hvert sertifikat forsegles for seg og kan hentes eller følges enkeltvis.

Parametere

Navn	Type	Påkrevd	Beskrivelse
`identifiers`	array	Ja	Liste med VIN-numre eller registreringsnumre (maks 100 per forespørsel)
`country`	string	Ja	ISO-landkode som gjelder for hele gruppen, for eksempel FR
`depth`	string	Nei	Sertifiseringsdybde for hvert element: standard (standardvalg) eller full

Eksempelforespørsel

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

Kjøretøyidentitet

Dekod en VIN mot offisielle produsentregistre for å få merke, modell, årsmodell og sertifiserte spesifikasjoner, uten å utstede et fullt sertifikat.

Parametere

Navn	Type	Påkrevd	Beskrivelse
`vin`	string	Ja	Kjøretøyets identifikasjonsnummer på 17 tegn (stiparameter)
`include_specs`	boolean	Nei	Ta med fullstendige sertifiserte tekniske spesifikasjoner

Eksempelforespørsel

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 sertifikat returneres som et enhetlig JSON-objekt: en unik certificate_id, et kontrollsegl, det dekodede kjøretøyet, de sertifiserte kontrollene, en tillitsscore og metadata som dokumenterer konteksten for forespørselen.

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"
  }
}

Felt i svaret

certificate_idUnik identifikator for det utstedte sertifikatet, med prefikset cert_

vinKjøretøyets sertifiserte identifikasjonsnummer

certified_atISO 8601-tidsstempel for når sertifikatet ble forseglet

sealForfalskningssikret kontrollsegl, med id (prefikset seal_) og valid-flagg

vehicleDekodet kjøretøyidentitet: merke, modell og årsmodell

checks.mileageKilometerstand med enhet og sertifisert kontrollstatus

checks.accidentsAntall sertifiserte ulykkesoppføringer

checks.theftTyveristatus kontrollert mot offisielle politiregistre: none eller flagged

checks.titleStatus for anmerkninger kontrollert mot det offisielle registeret: clean eller branded

official_sourcesTotalt antall offisielle datakilder som er kryssjekket for dette sertifikatet

confidence_scoreSertifiseringens tillitsscore på en skala fra 0 til 10

metaKonteksten for forespørselen: registreringsland og sertifiseringsdybde

Feilhåndtering

API-et bruker standard HTTP-statuskoder. Hver feil returnerer en beskrivende melding og et detail-felt med en forespørsels-ID, til hjelp for feilsøking og revisjon.

Kode	Melding	Beskrivelse
400	Bad Request	Forespørselens innhold eller parametere er feilformatert, eller påkrevde felt mangler.
401	Unauthorized	API-nøkkelen mangler, er ugyldig eller er trukket tilbake.
403	Forbidden	API-nøkkelen har ikke tilgang til dette endepunktet eller denne ressursen.
404	Not Found	Ressursen det ble spurt etter (sertifikat, kjøretøy), ble ikke funnet.
429	Too Many Requests	Forespørselsgrensen er overskredet. Sjekk X-Certificate-RateLimit-headerne og prøv igjen etter at vinduet er nullstilt.
500	Server Error	Det oppsto en intern feil. Prøv forespørselen på nytt, eller kontakt kundestøtten hvis den vedvarer.

Eksempel på feilsvar

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

Forespørselsgrenser

API-forespørsler er begrenset etter abonnementsnivå, hvert med sin egen avtalefestede SLA. Aktuell bruk av grensen rapporteres i svarheaderne for hvert kall.

Starter

Forespørsler/min

Forespørsler/dag

1,000

Samtidige

Vekst

Forespørsler/min

300

Forespørsler/dag

10,000

Samtidige

Bedrift

Forespørsler/min

1,000+

Forespørsler/dag

Ubegrenset

Samtidige

100+

Headere for forespørselsgrenser

Hvert API-svar inneholder headere, slik at du kan følge bruken opp mot SLA-en din i sanntid.

X-Certificate-RateLimit-Limit, maks antall forespørsler tillatt per vindu
X-Certificate-RateLimit-Remaining, forespørsler igjen i inneværende vindu
X-Certificate-RateLimit-Reset, Unix-tidsstempel for når grensen nullstilles

Webhooks

Motta signerte varsler i sanntid når et sertifikat utstedes, eller når viktige hendelser skjer på kontoen. Sett opp og verifiser webhook-endepunkter fra dashbordet ditt.

Støttede hendelser

certificate.issued, et sertifikat ble forseglet og utstedt
certificate.failed, sertifiseringen kunne ikke fullføres
bulk.completed, alle sertifikatene i gruppen er forseglet
bulk.partial, noen av sertifikatene i gruppen er forseglet
subscription.usage, nærmer seg forespørselsgrensen eller kvoten

Sikkerhet for webhooks

Hver webhook-melding signeres med HMAC-SHA256 og din webhook-hemmelighet. Kontroller X-Certificate-Signature-headeren for å bekrefte ekthet og integritet før du behandler den.

Eksempel på webhook-melding

{
  "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 å bygge på sertifiserte data?

Opprett din sertifiserte utviklerkonto, og begynn allerede i dag å integrere offisielle kjøretøydata med SLA i applikasjonene dine.

Hent API-nøkkelen din Kontakt salg