API certificiranih podataka

API certificiranih podataka o vozilima za razvojne programere

Ugradite certificirane podatke o povijesti vozila, spremne za reviziju, u svoju aplikaciju putem našeg REST API-ja. Izvor su više od 900 službenih registara i 1B+ provjerenih zapisa iz 45+ zemalja, uz SLA dostupnosti od 99,95 %.

https://api.autocertif.com/v1

Započnite Pogledajte krajnje točke

Brzi početak

Nabavite svoj API ključ

Otvorite certificirani poslovni račun i generirajte API ključ s nadzorne ploče. Ključevi za testno okruženje dostupni su za provjere usklađenosti, bez naplate zahtjeva.

Uputite prvi poziv

Autentificirajte se svojim API ključem i ključem certifikata, a zatim pošaljite prvi zahtjev na bilo koju krajnju točku. Počnite s krajnjom točkom za identitet vozila i dobit ćete trenutačan odgovor s navedenim izvorima.

Preuzmite rezultate

Primite strukturirani JSON s certificiranim podacima o vozilu, navedenim izvorom i vremenskom oznakom provjere za svako polje. Rezultate obradite, prikažite ili arhivirajte prema potrebi.

Autentifikacija

Svaki se API zahtjev autentificira dvjema vjerodajnicama: Bearer tokenom u zaglavlju Authorization i vašim zaglavljem X-Certificate-Key. Ključevi se izdaju, mijenjaju i opozivaju s vaše certificirane poslovne nadzorne ploče, uz potpuno bilježenje pristupa radi usklađenosti.

Primjer zahtjeva

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"

Čuvajte svoje ključeve! Nikada ne otkrivajte svoj API ključ ni X-Certificate-Key u kodu na strani klijenta. Pohranite ih u varijable okruženja i pozive usmjeravajte kroz poslužiteljski proxy kako bi vaše vjerodajnice i zapisi revizije ostali sigurni.

Krajnje točke

API certificiranih podataka nudi pet osnovnih krajnjih točaka: zahtjev za certificirano izvješće, dohvat certifikata, praćenje statusa certifikacije, skupnu certifikaciju i utvrđivanje identiteta po VIN-u. Svaki certifikat nosi pečat otporan na izmjene, naveden izvor i vremensku oznaku certified_at.

POST/v1/certificates

Zatraži certifikat

Zatražite certificirano izvješće o vozilu na temelju VIN-a ili registarske oznake. Svaki je podatak povezan sa svojim službenim izvorom, zapečaćen i vremenski označen.

Parametri

Naziv	Vrsta	Obavezno	Opis
`vin`	string	Uvjetno	Identifikacijski broj vozila od 17 znakova. Obavezan osim ako je naveden license_plate.
`license_plate`	string	Uvjetno	Registarska oznaka. Obavezna osim ako je naveden vin.
`country`	string	Da	ISO kôd zemlje registracije, primjerice FR
`depth`	string	Ne	Dubina certifikacije: standard (zadano) ili full

Primjer zahtjeva

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}

Dohvati certifikat

Dohvatite prethodno izdan certifikat prema njegovu identifikatoru, zajedno s pečatom, provjerama i ocjenom pouzdanosti.

Parametri

Naziv	Vrsta	Obavezno	Opis
`certificate_id`	string	Da	Identifikator certifikata vraćen pri zahtjevu za izvješće (parametar putanje)

Primjer zahtjeva

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

Status certifikata

Provjerite status obrade i certifikacije certifikata dok se njegovi službeni izvori još provjeravaju.

Parametri

Naziv	Vrsta	Obavezno	Opis
`certificate_id`	string	Da	Identifikator certifikata koji se pregledava (parametar putanje)

Primjer zahtjeva

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

Skupni certifikati

Pošaljite skup identifikatora na certifikaciju u jednom pozivu. Svaki se certifikat pečati zasebno te se može dohvatiti ili pratiti pojedinačno.

Parametri

Naziv	Vrsta	Obavezno	Opis
`identifiers`	array	Da	Niz VIN-ova ili registarskih oznaka (najviše 100 po zahtjevu)
`country`	string	Da	ISO kôd zemlje primijenjen na cijeli skup, primjerice FR
`depth`	string	Ne	Dubina certifikacije primijenjena na svaku stavku: standard (zadano) ili full

Primjer zahtjeva

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

Identitet vozila

Dekodirajte VIN prema službenim registrima proizvođača i dobijte marku, model, godinu i certificirane specifikacije, bez izdavanja punog certifikata.

Parametri

Naziv	Vrsta	Obavezno	Opis
`vin`	string	Da	Identifikacijski broj vozila od 17 znakova (parametar putanje)
`include_specs`	boolean	Ne	Uključi potpune certificirane tehničke specifikacije

Primjer zahtjeva

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

Format odgovora

Svaki se certifikat vraća kao dosljedan JSON objekt: jedinstven certificate_id, pečat provjere, dekodirano vozilo, certificirane provjere, ocjena pouzdanosti i metapodaci koji dokumentiraju kontekst zahtjeva.

JSON odgovor

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

certificate_idJedinstven identifikator izdanog certifikata, s prefiksom cert_

vinCertificirani identifikacijski broj vozila

certified_atVremenska oznaka ISO 8601 u trenutku pečaćenja certifikata

sealPečat provjere otporan na izmjene, s vlastitim id-om (prefiks seal_) i oznakom valid

vehicleDekodiran identitet vozila: marka, model i godina

checks.mileageStanje brojila s mjernom jedinicom i certificiranim statusom provjere

checks.accidentsBroj certificiranih zapisa o nesrećama

checks.theftStatus krađe provjeren u službenim policijskim bazama: none ili flagged

checks.titleVlasnički i pravni status certificiran prema službenom registru: clean ili branded

official_sourcesUkupan broj službenih izvora podataka unakrsno provjerenih za ovaj certifikat

confidence_scorePouzdanost certifikacije na ljestvici od 0 do 10

metaKontekst zahtjeva: zemlja registracije i dubina certifikacije

Obrada pogrešaka

API koristi standardne HTTP statusne kodove. Svaka pogreška vraća opisnu poruku i polje detail s ID-om zahtjeva radi lakšeg otklanjanja pogrešaka i revizije.

Kôd	Poruka	Opis
400	Bad Request	Tijelo zahtjeva ili parametri neispravno su oblikovani ili nedostaju obavezna polja.
401	Unauthorized	API ključ nedostaje, nije valjan ili je opozvan.
403	Forbidden	API ključ nema dopuštenje za ovu krajnju točku ili resurs.
404	Not Found	Traženi resurs (certifikat, vozilo) nije pronađen.
429	Too Many Requests	Prekoračeno je ograničenje zahtjeva. Provjerite zaglavlja X-Certificate-RateLimit i pokušajte ponovno nakon isteka razdoblja.
500	Server Error	Došlo je do interne pogreške. Ponovite zahtjev ili se obratite podršci ako se problem nastavi.

Primjer odgovora s pogreškom

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

Ograničenja zahtjeva

Broj API zahtjeva ograničen je prema razini pretplate, a svaku uređuje ugovorni SLA. Trenutačna potrošnja ograničenja navodi se u zaglavljima odgovora svakog poziva.

Starter

Zahtjeva / min

Zahtjeva / dan

1,000

Istodobnih

Growth

Zahtjeva / min

300

Zahtjeva / dan

10,000

Istodobnih

Enterprise

Zahtjeva / min

1,000+

Zahtjeva / dan

Neograničeno

Istodobnih

100+

Zaglavlja ograničenja zahtjeva

Svaki odgovor API-ja sadrži zaglavlja pomoću kojih u stvarnom vremenu pratite potrošnju u odnosu na svoj SLA.

X-Certificate-RateLimit-Limit, najveći dopušten broj zahtjeva po razdoblju
X-Certificate-RateLimit-Remaining, broj preostalih zahtjeva u tekućem razdoblju
X-Certificate-RateLimit-Reset, Unix vremenska oznaka ponovnog postavljanja ograničenja

Webhookovi

Primajte potpisane obavijesti u stvarnom vremenu čim je certifikat izdan ili kada se dogode važni događaji na računu. Krajnje točke webhookova postavljate i provjeravate s nadzorne ploče.

Podržani događaji

certificate.issued, certifikat je uspješno zapečaćen i izdan
certificate.failed, certifikacija nije mogla biti dovršena
bulk.completed, svi certifikati u skupu su zapečaćeni
bulk.partial, dio certifikata u skupu je zapečaćen
subscription.usage, približavanje ograničenju zahtjeva ili kvoti

Sigurnost webhookova

Svaki se sadržaj webhooka potpisuje algoritmom HMAC-SHA256 uz vašu tajnu vrijednost. Prije obrade provjerite zaglavlje X-Certificate-Signature kako biste potvrdili vjerodostojnost i cjelovitost.

Primjer sadržaja 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"
  }
}

Spremni graditi na certificiranim podacima?

Otvorite certificirani razvojni račun i već danas počnite ugrađivati službene podatke o vozilima, potkrijepljene SLA-om, u svoje aplikacije.

Nabavite svoj API ključ Kontaktirajte prodaju