API certificiranih podatkov

API certificiranih podatkov o vozilih za razvijalce

Certificirane in revizijsko preverljive podatke o zgodovini vozil vgradite v svojo aplikacijo prek našega API REST. Zajeti so iz več kot 900 uradnih registrov in več kot 1 milijarde preverjenih zapisov v več kot 45 državah, s SLA razpoložljivosti 99,95 %.

https://api.autocertif.com/v1

Začnite Ogled končnih točk

Hitri začetek

Pridobite ključ API

Ustvarite certificiran poslovni račun in na nadzorni plošči ustvarite svoj ključ API. Za preizkušanje skladnosti so na voljo ključi za peskovnik, ki se ne obračunajo.

Opravite prvi klic

Prijavite se s svojim ključem API in ključem certifikata, nato pošljite prvo zahtevo na poljubno končno točko. Začnite s končno točko za identiteto vozila in prejmite takojšen odziv z navedenimi viri.

Prejmite rezultate

Prejmete strukturiran JSON s certificiranimi podatki o vozilu, navedbo vira in časovnim žigom preverjanja pri vsakem polju. Rezultate razčlenite, prikažite ali arhivirajte po svojih potrebah.

Avtentikacija

Vsaka zahteva API se preveri z dvema poverilnicama: žetonom Bearer v glavi Authorization in vašo glavo X-Certificate-Key. Ključe izdate, zamenjate in prekličete na svoji certificirani poslovni nadzorni plošči, kjer se za skladnost beleži celoten dostop.

Primer zahteve

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"

Skrbno varujte svoje ključe! Svojega ključa API ali ključa X-Certificate-Key nikoli ne izpostavljajte v kodi na strani odjemalca. Shranite ju v okoljske spremenljivke in klice usmerite prek strežniškega posrednika, da ostanejo vaše poverilnice in revizijska sled varne.

Končne točke

API certificiranih podatkov ponuja pet osrednjih končnih točk: naročilo certificiranega poročila, prevzem certifikata, spremljanje stanja certificiranja, množično certificiranje in razrešitev identitete po številki VIN. Vsak certifikat nosi nespremenljiv pečat, navedbo virov in časovni žig certified_at.

POST/v1/certificates

Naročilo certifikata

Naročite certificirano poročilo o vozilu po številki VIN ali registrski oznaki. Vsak podatek je izsleden do uradnega vira, zapečaten in opremljen s časovnim žigom.

Parametri

Ime	Tip	Obvezno	Opis
`vin`	string	Pogojno	17-mestna identifikacijska številka vozila. Obvezna, razen če je podan license_plate.
`license_plate`	string	Pogojno	Registrska oznaka. Obvezna, razen če je podan vin.
`country`	string	Da	Koda države registracije po ISO, na primer FR
`depth`	string	Ne	Globina certificiranja: standard (privzeto) ali full

Primer zahteve

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}

Prevzem certifikata

Prevzemite že izdan certifikat po njegovem identifikatorju, skupaj s pečatom, preverjanji in oceno zanesljivosti.

Parametri

Ime	Tip	Obvezno	Opis
`certificate_id`	string	Da	Identifikator certifikata, vrnjen ob naročilu poročila (parameter poti)

Primer zahteve

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

Stanje certifikata

Preverite stanje obdelave in certificiranja certifikata, medtem ko poteka preverjanje njegovih uradnih virov.

Parametri

Ime	Tip	Obvezno	Opis
`certificate_id`	string	Da	Identifikator certifikata za vpogled (parameter poti)

Primer zahteve

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

Množično certificiranje

V enem klicu pošljite paket identifikatorjev v certificiranje. Vsak certifikat je zapečaten samostojno, prevzamete ali spremljate pa ga lahko posamično.

Parametri

Ime	Tip	Obvezno	Opis
`identifiers`	array	Da	Polje nizov s številkami VIN ali registrskimi oznakami (največ 100 na zahtevo)
`country`	string	Da	Koda države po ISO za celoten paket, na primer FR
`depth`	string	Ne	Globina certificiranja za vsak element: standard (privzeto) ali full

Primer zahteve

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

Identiteta vozila

Dekodirajte številko VIN v uradnih registrih proizvajalcev in prejmite znamko, model, letnik in certificirane specifikacije, brez izdaje celotnega certifikata.

Parametri

Ime	Tip	Obvezno	Opis
`vin`	string	Da	17-mestna identifikacijska številka vozila (parameter poti)
`include_specs`	boolean	Ne	Vključi celotne certificirane tehnične specifikacije

Primer zahteve

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

Oblika odziva

Vsak certifikat je vrnjen kot enoten objekt JSON: enolični certificate_id, potrditveni pečat, dekodirano vozilo, certificirana preverjanja, ocena zanesljivosti in metapodatki o okoliščinah zahteve.

Odziv JSON

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

Polja odziva

certificate_idEnolični identifikator izdanega certifikata s predpono cert_

vinCertificirana identifikacijska številka vozila

certified_atČasovni žig ISO 8601, kdaj je bil certifikat zapečaten

sealNespremenljiv potrditveni pečat z lastnim id (predpona seal_) in zastavico valid

vehicleDekodirana identiteta vozila: znamka, model in letnik

checks.mileageOdčitek števca z enoto in certificiranim stanjem preverjanja

checks.accidentsŠtevilo certificiranih zapisov o nesrečah

checks.theftStanje kraje, preverjeno v uradnih bazah organov pregona: none ali flagged

checks.titleStanje lastniškega dokumenta, certificirano v uradnem registru: clean ali branded

official_sourcesSkupno število uradnih virov podatkov, navzkrižno preverjenih za ta certifikat

confidence_scoreZanesljivost certificiranja na lestvici od 0 do 10

metaOkoliščine zahteve: država registracije in globina certificiranja

Obravnava napak

API uporablja standardne statusne kode HTTP. Vsaka napaka vrne opisno sporočilo in polje detail z identifikatorjem zahteve, kar olajša odpravljanje napak in revizijo.

Koda	Sporočilo	Opis
400	Neveljavna zahteva	Telo zahteve ali parametri so napačno oblikovani ali pa manjkajo obvezna polja.
401	Nepooblaščen dostop	Ključ API manjka, je neveljaven ali je bil preklican.
403	Prepovedano	Ključ API nima dovoljenja za to končno točko ali vir.
404	Ni najdeno	Zahtevanega vira (certifikata, vozila) ni bilo mogoče najti.
429	Preveč zahtev	Omejitev zahtev je presežena. Preverite glave X-Certificate-RateLimit in poskusite znova po ponastavitvi okna.
500	Napaka strežnika	Prišlo je do notranje napake. Zahtevo ponovite ali se obrnite na podporo, če se napaka ponavlja.

Primer odziva z napako

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

Omejitve zahtev

Zahteve API so omejene glede na raven naročnine, vsako pa ureja pogodbeni SLA. Trenutna poraba omejitve je navedena v glavah odziva pri vsakem klicu.

Začetna

Zahtev/min

Zahtev/dan

1,000

Hkratnih

Rast

Zahtev/min

300

Zahtev/dan

10,000

Hkratnih

Podjetniška

Zahtev/min

1,000+

Zahtev/dan

Neomejeno

Hkratnih

100+

Glave omejitev zahtev

Vsak odziv API vsebuje glave, da lahko porabo glede na svoj SLA spremljate v realnem času.

X-Certificate-RateLimit-Limit, največje dovoljeno število zahtev v oknu
X-Certificate-RateLimit-Remaining, preostale zahteve v trenutnem oknu
X-Certificate-RateLimit-Reset, časovni žig Unix, kdaj se omejitev ponastavi

Webhooki

Prejemajte podpisana obvestila v realnem času, ko je certifikat izdan ali ko se zgodi pomemben dogodek na računu. Končne točke za webhooke nastavite in preverite na svoji nadzorni plošči.

Podprti dogodki

certificate.issued, certifikat je bil zapečaten in uspešno izdan
certificate.failed, certificiranja ni bilo mogoče dokončati
bulk.completed, vsi certifikati v paketu so zapečateni
bulk.partial, del certifikatov v paketu je zapečatenih
subscription.usage, bližate se omejitvi zahtev ali pragu kvote

Varnost webhookov

Vsaka vsebina webhooka je podpisana s HMAC-SHA256 z uporabo vaše skrivnosti za webhooke. Pred obdelavo preverite glavo X-Certificate-Signature in tako potrdite pristnost ter celovitost.

Primer vsebine webhooka

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

Pripravljeni graditi na certificiranih podatkih?

Ustvarite svoj certificirani razvijalski račun in že danes začnite v svoje aplikacije vgrajevati uradne podatke o vozilih, podprte s SLA.

Pridobite ključ API Stik s prodajo