Sertifitseeritud andmete API

Sertifitseeritud sõidukiandmete API arendajatele

Liidestage sertifitseeritud ja auditikõlblikud sõidukiajaloo andmed oma rakendusse meie RESTful API kaudu. Andmed pärinevad enam kui 900 ametlikust registrist ja 1B+ kontrollitud kirjest 45+ riigis, ning neid katab 99,95% käideldavuse SLA.

https://api.autocertif.com/v1

Alustage Vaadake lõpp-punkte

Kiirjuhend

Hankige oma API-võti

Registreerige sertifitseeritud ärikonto ja looge töölaual oma API-võti. Vastavuskontrolli testimiseks on saadaval liivakastivõtmed, ilma päringutasudeta.

Tehke oma esimene päring

Autentige oma API-võtme ja sertifikaadivõtmega ning saatke seejärel esimene päring ükskõik millisele lõpp-punktile. Alustage sõiduki tuvastuse lõpp-punktist, et saada kohene ja allikaga varustatud vastus.

Saage tulemused

Saate struktureeritud JSON-i, mis sisaldab sertifitseeritud sõidukiandmeid, allikaviidet ja kontrolli ajatemplit igal väljal. Töödelge, kuvage või arhiveerige tulemused nii, nagu vaja.

Autentimine

Iga API-päring autenditakse kahe mandaadiga: Bearer-tokeniga päises Authorization ja teie X-Certificate-Key päisega. Võtmeid väljastatakse, vahetatakse ja tühistatakse teie sertifitseeritud ärikonto töölaualt, kusjuures kogu ligipääs logitakse vastavusnõuete täitmiseks.

Näidispäring

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"

Hoidke oma võtmed turvaliselt! Ärge kunagi avaldage oma API-võtit ega X-Certificate-Key väärtust kliendipoolses koodis. Hoidke neid keskkonnamuutujates ja suunake päringud läbi serveripoolse vahendaja, et teie mandaadid ja auditijälg jääksid turvaliseks.

Lõpp-punktid

Sertifitseeritud andmete API pakub viit põhilist lõpp-punkti: sertifitseeritud aruande taotlemine, sertifikaadi hankimine, sertifitseerimise oleku jälgimine, hulgisertifitseerimine ja VIN-i tuvastamine. Iga sertifikaat kannab võltsimiskindlat pitserit, allikaviidet ja certified_at ajatemplit.

POST/v1/certificates

Sertifikaadi taotlemine

Taotlege VIN-i või numbrimärgi alusel sertifitseeritud sõidukiaruannet. Iga andmepunkt on jälgitav oma ametliku allikani, pitseeritud ja ajatempliga varustatud.

Parameetrid

Nimi	Tüüp	Kohustuslik	Kirjeldus
`vin`	string	Tingimuslik	17-märgiline sõiduki tehasetähis. Kohustuslik, kui license_plate ei ole antud.
`license_plate`	string	Tingimuslik	Registreerimismärk. Kohustuslik, kui vin ei ole antud.
`country`	string	Jah	Registreerimisriigi ISO-kood, näiteks FR
`depth`	string	Ei	Sertifitseerimise sügavus: standard (vaikimisi) või full

Näidispäring

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}

Sertifikaadi hankimine

Hankige varem väljastatud sertifikaat selle tunnuse alusel, koos pitseri, tehtud kontrollide ja usaldusskooriga.

Parameetrid

Nimi	Tüüp	Kohustuslik	Kirjeldus
`certificate_id`	string	Jah	Sertifikaadi tunnus, mis tagastati aruande taotlemisel (tee parameeter)

Näidispäring

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

Sertifikaadi olek

Kontrollige sertifikaadi töötlemise ja sertifitseerimise olekut ajal, mil selle ametlikke allikaid kontrollitakse.

Parameetrid

Nimi	Tüüp	Kohustuslik	Kirjeldus
`certificate_id`	string	Jah	Vaadeldava sertifikaadi tunnus (tee parameeter)

Näidispäring

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

Hulgisertifikaadid

Esitage ühe päringuga hulk tunnuseid sertifitseerimiseks. Iga sertifikaat pitseeritakse eraldi ning seda saab hankida või jälgida ükshaaval.

Parameetrid

Nimi	Tüüp	Kohustuslik	Kirjeldus
`identifiers`	array	Jah	VIN-ide või numbrimärkide massiiv (kuni 100 päringu kohta)
`country`	string	Jah	Kogu partiile rakendatav ISO riigikood, näiteks FR
`depth`	string	Ei	Igale kirjele rakendatav sertifitseerimise sügavus: standard (vaikimisi) või full

Näidispäring

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

Sõiduki tuvastus

Dekodeerige VIN ametlike tootjaregistrite vastu, et saada mark, mudel, aasta ja sertifitseeritud tehnilised andmed, ilma täielikku sertifikaati väljastamata.

Parameetrid

Nimi	Tüüp	Kohustuslik	Kirjeldus
`vin`	string	Jah	17-märgiline sõiduki tehasetähis (tee parameeter)
`include_specs`	boolean	Ei	Lisa täielikud sertifitseeritud tehnilised andmed

Näidispäring

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

Vastuse vorming

Iga sertifikaat tagastatakse ühtse JSON-objektina: unikaalne certificate_id, kontrollpitser, dekodeeritud sõiduk, sertifitseeritud kontrollid, usaldusskoor ja metaandmed, mis dokumenteerivad päringu konteksti.

JSON-vastus

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

Vastuse väljad

certificate_idVäljastatud sertifikaadi unikaalne tunnus, eesliitega cert_

vinSertifitseeritud sõiduki tehasetähis

certified_atISO 8601 ajatempel, millal sertifikaat pitseeriti

sealVõltsimiskindel kontrollpitser koos oma tunnusega (eesliitega seal_) ja kehtivuslipuga

vehicleDekodeeritud sõiduki identiteet: mark, mudel ja aasta

checks.mileageOdomeetri näit koos ühiku ja sertifitseeritud kontrolli olekuga

checks.accidentsSertifitseeritud avariikirjete arv

checks.theftVarguse olek, kontrollitud ametlike õiguskaitseandmebaaside vastu: none või flagged

checks.titleDokumendi staatus, sertifitseeritud ametliku registri vastu: clean või branded

official_sourcesSelle sertifikaadi jaoks ristkontrollitud ametlike andmeallikate koguarv

confidence_scoreSertifitseerimise usaldusväärsus skaalal 0 kuni 10

metaPäringu kontekst: registreerimisriik ja sertifitseerimise sügavus

Vigade käsitlemine

API kasutab standardseid HTTP olekukoode. Iga viga tagastab kirjeldava sõnumi ja välja detail koos päringu tunnusega, mis toetab silumist ja auditit.

Kood	Sõnum	Kirjeldus
400	Vigane päring	Päringu keha või parameetrid on vigased või kohustuslikud väljad puuduvad.
401	Autoriseerimata	API-võti puudub, on kehtetu või on tühistatud.
403	Keelatud	API-võtmel puudub õigus sellele lõpp-punktile või ressursile.
404	Ei leitud	Soovitud ressurssi (sertifikaat, sõiduk) ei leitud.
429	Liiga palju päringuid	Päringulimiit on ületatud. Kontrollige X-Certificate-RateLimit päiseid ja proovige pärast lähtestamisakent uuesti.
500	Serveri viga	Tekkis sisemine viga. Korrake päringut või võtke ühendust toega, kui viga püsib.

Veavastuse näide

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

Päringulimiidid

API-päringute arv on piiratud vastavalt tellimuse astmele, millest igaüht reguleerib lepinguline SLA. Praegust limiidi kasutust näidatakse iga päringu vastusepäistes.

Alustaja

Päringut / min

Päringut / päevas

1,000

Samaaegseid

Kasv

Päringut / min

300

Päringut / päevas

10,000

Samaaegseid

Ettevõte

Päringut / min

1,000+

Päringut / päevas

Piiramatu

Samaaegseid

100+

Päringulimiidi päised

Iga API-vastus sisaldab päiseid, et saaksite reaalajas jälgida kasutust oma SLA suhtes.

X-Certificate-RateLimit-Limit, suurim lubatud päringute arv ajaakna kohta
X-Certificate-RateLimit-Remaining, praeguses ajaaknas alles jäänud päringud
X-Certificate-RateLimit-Reset, Unixi ajatempel, millal päringulimiit lähtestub

Webhookid

Saage reaalajas allkirjastatud teavitusi, kui sertifikaat väljastatakse või kui kontol toimub oluline sündmus. Seadistage ja kontrollige webhooki lõpp-punkte oma töölaualt.

Toetatud sündmused

certificate.issued, sertifikaat pitseeriti ja väljastati edukalt
certificate.failed, sertifitseerimist ei õnnestunud lõpule viia
bulk.completed, kõik partii sertifikaadid on pitseeritud
bulk.partial, osa partii sertifikaate on pitseeritud
subscription.usage, päringulimiidi või kvoodi lävi läheneb

Webhookide turvalisus

Iga webhooki sisu allkirjastatakse HMAC-SHA256 abil teie webhooki salavõtmega. Enne töötlemist kontrollige päist X-Certificate-Signature, et kinnitada saadetise ehtsus ja terviklikkus.

Webhooki sisu näide

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

Kas olete valmis ehitama sertifitseeritud andmetele?

Looge oma sertifitseeritud arendajakonto ja hakake juba täna liidestama oma rakendustesse ametlikke, SLA-ga kaetud sõidukiandmeid.

Hankige oma API-võti Võtke ühendust müügiga