API för certifierade data

API med certifierade fordonsdata för utvecklare

Bygg in certifierad, granskningsklar fordonshistorik i din applikation via vårt RESTful API. Hämtad från över 900 officiella register och 1B+ verifierade uppgifter i 45+ länder, med en SLA på 99,95 % drifttid.

https://api.autocertif.com/v1

Kom igång Se endpoints

Snabbstart

Hämta din API-nyckel

Registrera ett certifierat företagskonto och generera din API-nyckel i panelen. Sandbox-nycklar finns för tester av regelefterlevnad, utan att anropen debiteras.

Gör ditt första anrop

Autentisera med din API-nyckel och din certifikatnyckel och skicka sedan din första förfrågan till valfri endpoint. Börja med endpointen för fordonsidentitet för ett omedelbart, källspårat svar.

Få resultatet

Ta emot strukturerad JSON med certifierade fordonsdata, källhänvisning och en verifieringstidsstämpel på varje fält. Tolka, visa eller arkivera resultaten efter behov.

Autentisering

Varje API-förfrågan autentiseras med två uppgifter: en Bearer-token i Authorization-huvudet och ditt X-Certificate-Key-huvud. Nycklar utfärdas, roteras och återkallas från din certifierade företagspanel, med fullständig åtkomstloggning för regelefterlevnad.

Exempelförfrågan

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"

Håll dina nycklar säkra! Exponera aldrig din API-nyckel eller din X-Certificate-Key i klientkod. Lagra dem i miljövariabler och skicka anropen via en serverproxy, så att dina uppgifter och din granskningslogg förblir skyddade.

Endpoints

API:et för certifierade data har fem centrala endpoints: begära en certifierad rapport, hämta ett certifikat, följa certifieringens status, köra certifiering i bulk och slå upp en VIN-identitet. Varje certifikat bär ett manipulationssäkert sigill, en källhänvisning och en certified_at-tidsstämpel.

POST/v1/certificates

Begär certifikat

Begär en certifierad fordonsrapport utifrån ett VIN eller ett registreringsnummer. Varje uppgift spåras till sin officiella källa, förseglas och tidsstämplas.

Parametrar

Namn	Typ	Obligatorisk	Beskrivning
`vin`	string	Villkorlig	Fordonsidentifieringsnummer på 17 tecken. Obligatoriskt om inte license_plate anges.
`license_plate`	string	Villkorlig	Registreringsnummer. Obligatoriskt om inte vin anges.
`country`	string	Ja	ISO-landskod för registreringen, till exempel FR
`depth`	string	Nej	Certifieringsdjup: standard (förval) eller full

Exempelförfrågan

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}

Hämta certifikat

Hämta ett tidigare utfärdat certifikat via dess identifierare, inklusive sigill, kontroller och tillförlitlighetspoäng.

Parametrar

Namn	Typ	Obligatorisk	Beskrivning
`certificate_id`	string	Ja	Certifikatets identifierare, som returnerades när rapporten begärdes (sökvägsparameter)

Exempelförfrågan

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

Certifikatstatus

Kontrollera bearbetnings- och certifieringsstatus för ett certifikat medan dess officiella källor verifieras.

Parametrar

Namn	Typ	Obligatorisk	Beskrivning
`certificate_id`	string	Ja	Identifieraren för det certifikat som ska granskas (sökvägsparameter)

Exempelförfrågan

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

Certifikat i bulk

Skicka in en grupp identifierare för certifiering i ett enda anrop. Varje certifikat förseglas för sig och kan hämtas eller följas individuellt.

Parametrar

Namn	Typ	Obligatorisk	Beskrivning
`identifiers`	array	Ja	Lista med VIN eller registreringsnummer som strängar (max 100 per förfrågan)
`country`	string	Ja	ISO-landskod som tillämpas på hela gruppen, till exempel FR
`depth`	string	Nej	Certifieringsdjup som tillämpas på varje post: standard (förval) eller full

Exempelförfrågan

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

Fordonsidentitet

Avkoda ett VIN mot officiella tillverkarregister och få märke, modell, årsmodell och certifierade specifikationer, utan att ett fullständigt certifikat utfärdas.

Parametrar

Namn	Typ	Obligatorisk	Beskrivning
`vin`	string	Ja	Fordonsidentifieringsnummer på 17 tecken (sökvägsparameter)
`include_specs`	boolean	Nej	Inkludera fullständiga certifierade tekniska specifikationer

Exempelförfrågan

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

Svarsformat

Varje certifikat returneras som ett enhetligt JSON-objekt: ett unikt certificate_id, ett verifieringssigill, det avkodade fordonet, de certifierade kontrollerna, en tillförlitlighetspoäng och metadata som dokumenterar förfrågans sammanhang.

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

Svarsfält

certificate_idUnik identifierare för det utfärdade certifikatet, med prefixet cert_

vinDet certifierade fordonsidentifieringsnumret

certified_atISO 8601-tidsstämpel för när certifikatet förseglades

sealManipulationssäkert verifieringssigill, med sitt id (prefixet seal_) och flaggan valid

vehicleAvkodad fordonsidentitet: märke, modell och årsmodell

checks.mileageMätarställning med enhet och certifierad verifieringsstatus

checks.accidentsAntal certifierade olycksnoteringar

checks.theftStöldstatus verifierad mot officiella polisregister: none eller flagged

checks.titleRegisteranmärkningar certifierade mot det officiella registret: clean eller branded

official_sourcesTotalt antal officiella datakällor som korskontrollerats för detta certifikat

confidence_scoreCertifieringens tillförlitlighet på en skala från 0 till 10

metaFörfrågans sammanhang: registreringsland och certifieringsdjup

Felhantering

API:et använder vanliga HTTP-statuskoder. Varje fel returnerar ett beskrivande meddelande och ett detail-fält med ett förfrågnings-ID som stöd för felsökning och granskning.

Kod	Meddelande	Beskrivning
400	Felaktig förfrågan	Förfrågans innehåll eller parametrar är felaktigt utformade eller saknar obligatoriska fält.
401	Ej behörig	API-nyckeln saknas, är ogiltig eller har återkallats.
403	Åtkomst nekad	API-nyckeln har inte behörighet till denna endpoint eller resurs.
404	Hittades inte	Den begärda resursen (certifikat, fordon) hittades inte.
429	För många förfrågningar	Anropsgränsen är överskriden. Kontrollera X-Certificate-RateLimit-huvudena och försök igen efter återställningsfönstret.
500	Serverfel	Ett internt fel uppstod. Försök igen eller kontakta supporten om det kvarstår.

Exempel på felsvar

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

Anropsgränser

API-förfrågningar begränsas utifrån abonnemangsnivå, var och en styrd av ett avtalat SLA. Aktuell förbrukning redovisas i svarshuvudena för varje anrop.

Start

Förfrågningar/min

Förfrågningar/dygn

1,000

Samtidiga

Tillväxt

Förfrågningar/min

300

Förfrågningar/dygn

10,000

Samtidiga

Företag

Förfrågningar/min

1,000+

Förfrågningar/dygn

Obegränsat

Samtidiga

100+

Huvuden för anropsgränser

Varje API-svar innehåller huvuden så att du kan följa din förbrukning mot ditt SLA i realtid.

X-Certificate-RateLimit-Limit, högsta antal tillåtna förfrågningar per fönster
X-Certificate-RateLimit-Remaining, återstående förfrågningar i det aktuella fönstret
X-Certificate-RateLimit-Reset, Unix-tidsstämpel för när anropsgränsen återställs

Webhooks

Ta emot signerade aviseringar i realtid när ett certifikat utfärdas eller när viktiga kontohändelser inträffar. Konfigurera och verifiera dina webhook-endpoints i panelen.

Händelser som stöds

certificate.issued, ett certifikat har förseglats och utfärdats
certificate.failed, certifieringen kunde inte slutföras
bulk.completed, alla certifikat i gruppen är förseglade
bulk.partial, vissa certifikat i gruppen är förseglade
subscription.usage, anropsgränsen eller kvoten börjar närma sig

Webhook-säkerhet

Varje webhook-nyttolast signeras med HMAC-SHA256 och din webhook-hemlighet. Verifiera huvudet X-Certificate-Signature för att bekräfta äkthet och integritet innan du bearbetar den.

Exempel på webhook-nyttolast

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

Redo att bygga på certifierade data?

Skapa ditt certifierade utvecklarkonto och börja bygga in officiella fordonsdata med SLA i dina applikationer redan i dag.

Hämta din API-nyckel Kontakta säljteamet