API certifikovaných údajov

API certifikovaných údajov o vozidlách pre vývojárov

Zapojte do svojej aplikácie certifikované údaje o histórii vozidiel pripravené na audit, a to cez naše REST API. Čerpáme z vyše 900 oficiálnych registrov a 1 mld.+ overených záznamov v 45+ krajinách, so zárukou dostupnosti 99,95 % v rámci SLA.

https://api.autocertif.com/v1

Začať Koncové body

Rýchly štart

Získajte kľúč API

Zaregistrujte si certifikovaný firemný účet a v paneli si vygenerujte kľúč API. Na testovanie zhody sú k dispozícii sandbox kľúče bez spoplatnenia požiadaviek.

Spustite prvé volanie

Autentifikujte sa kľúčom API a certifikačným kľúčom a pošlite prvú požiadavku na ľubovoľný koncový bod. Začnite koncovým bodom identity vozidla, ktorý vráti okamžitú odpoveď s uvedením zdrojov.

Získajte výsledky

Dostanete štruktúrovaný JSON s certifikovanými údajmi o vozidle, uvedením zdroja a časovou pečiatkou overenia pri každom poli. Výsledky si spracujte, zobrazte alebo archivujte podľa potreby.

Autentifikácia

Každá požiadavka na API sa autentifikuje dvoma údajmi: tokenom Bearer v hlavičke Authorization a vašou hlavičkou X-Certificate-Key. Kľúče vydávate, obmieňate a rušíte vo svojom certifikovanom firemnom paneli, pričom sa pre účely zhody zaznamenáva každý prístup.

Ukážka požiadavky

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"

Chráňte svoje kľúče! Nikdy nevystavujte svoj kľúč API ani X-Certificate-Key v kóde na strane klienta. Uložte ich do premenných prostredia a volania smerujte cez serverovú proxy, aby vaše prihlasovacie údaje aj kontrolná stopa zostali v bezpečí.

Koncové body

API certifikovaných údajov sprístupňuje päť základných koncových bodov: vyžiadanie certifikovanej správy, načítanie certifikátu, sledovanie stavu certifikácie, hromadnú certifikáciu a zistenie identity podľa VIN. Každý certifikát nesie pečať odolnú proti pozmeneniu, uvedenie zdrojov a časovú pečiatku certified_at.

POST/v1/certificates

Vyžiadať certifikát

Vyžiadajte si certifikovanú správu o vozidle podľa VIN alebo evidenčného čísla. Každý údaj je naviazaný na svoj oficiálny zdroj, opečatený a opatrený časovou pečiatkou.

Parametre

Názov	Typ	Povinný	Popis
`vin`	string	Podmienečne	17-znakové identifikačné číslo vozidla. Povinné, ak nie je uvedené license_plate.
`license_plate`	string	Podmienečne	Evidenčné číslo vozidla. Povinné, ak nie je uvedené vin.
`country`	string	Áno	Kód krajiny evidencie podľa ISO, napríklad FR
`depth`	string	Nie	Hĺbka certifikácie: standard (predvolené) alebo full

Ukážka požiadavky

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}

Načítať certifikát

Načítajte skôr vydaný certifikát podľa jeho identifikátora vrátane pečate, vykonaných kontrol a skóre spoľahlivosti.

Parametre

Názov	Typ	Povinný	Popis
`certificate_id`	string	Áno	Identifikátor certifikátu vrátený pri vyžiadaní správy (parameter cesty)

Ukážka požiadavky

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

Stav certifikátu

Zistite stav spracovania a certifikácie certifikátu, kým prebieha overovanie jeho oficiálnych zdrojov.

Parametre

Názov	Typ	Povinný	Popis
`certificate_id`	string	Áno	Identifikátor certifikátu, ktorý chcete preveriť (parameter cesty)

Ukážka požiadavky

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

Hromadné certifikáty

Odošlite dávku identifikátorov na certifikáciu jediným volaním. Každý certifikát sa pečatí samostatne a dá sa načítať aj sledovať jednotlivo.

Parametre

Názov	Typ	Povinný	Popis
`identifiers`	array	Áno	Pole reťazcov s VIN alebo evidenčnými číslami (max. 100 na požiadavku)
`country`	string	Áno	Kód krajiny podľa ISO uplatnený na celú dávku, napríklad FR
`depth`	string	Nie	Hĺbka certifikácie uplatnená na každú položku: standard (predvolené) alebo full

Ukážka požiadavky

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

Identita vozidla

Dekódujte VIN voči oficiálnym registrom výrobcov a získajte značku, model, rok výroby a certifikované technické údaje bez vydania celého certifikátu.

Parametre

Názov	Typ	Povinný	Popis
`vin`	string	Áno	17-znakové identifikačné číslo vozidla (parameter cesty)
`include_specs`	boolean	Nie	Zahrnúť kompletné certifikované technické údaje

Ukážka požiadavky

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

Formát odpovede

Každý certifikát sa vracia ako jednotný objekt JSON: jedinečné certificate_id, overovacia pečať, dekódované vozidlo, certifikované kontroly, skóre spoľahlivosti a metadáta dokumentujúce kontext požiadavky.

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

Polia odpovede

certificate_idJedinečný identifikátor vydaného certifikátu s predponou cert_

vinCertifikované identifikačné číslo vozidla

certified_atČasová pečiatka podľa ISO 8601, kedy bol certifikát opečatený

sealOverovacia pečať odolná proti pozmeneniu, s vlastným id (predpona seal_) a príznakom valid

vehicleDekódovaná identita vozidla: značka, model a rok výroby

checks.mileageStav tachometra s jednotkou a certifikovaným stavom overenia

checks.accidentsPočet certifikovaných záznamov o nehodách

checks.theftStav krádeže overený voči oficiálnym policajným databázam: none alebo flagged

checks.titleStav dokladov certifikovaný voči oficiálnemu registru: clean alebo branded

official_sourcesCelkový počet oficiálnych zdrojov údajov porovnaných pre tento certifikát

confidence_scoreSpoľahlivosť certifikácie na stupnici od 0 do 10

metaKontext požiadavky: krajina evidencie a hĺbka certifikácie

Spracovanie chýb

API používa štandardné stavové kódy HTTP. Každá chyba vracia popisnú správu a pole detail s ID požiadavky, čo uľahčuje ladenie aj audit.

Kód	Správa	Popis
400	Chybná požiadavka	Telo požiadavky alebo parametre sú poškodené, prípadne chýbajú povinné polia.
401	Neautorizované	Kľúč API chýba, je neplatný alebo bol zrušený.
403	Zakázané	Kľúč API nemá oprávnenie na tento koncový bod alebo zdroj.
404	Nenájdené	Požadovaný zdroj (certifikát, vozidlo) sa nenašiel.
429	Priveľa požiadaviek	Prekročili ste limit požiadaviek. Skontrolujte hlavičky X-Certificate-RateLimit a skúste to znova po obnovení okna.
500	Chyba servera	Nastala interná chyba. Zopakujte požiadavku, a ak pretrváva, kontaktujte podporu.

Ukážka chybovej odpovede

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

Limity požiadaviek

Požiadavky na API sú obmedzené podľa úrovne predplatného, pričom každú upravuje zmluvné SLA. Aktuálne čerpanie limitu nájdete v hlavičkách odpovede pri každom volaní.

Štart

Požiadaviek/min

Požiadaviek/deň

1,000

Súbežne

Rast

Požiadaviek/min

300

Požiadaviek/deň

10,000

Súbežne

Podnik

Požiadaviek/min

1,000+

Požiadaviek/deň

Neobmedzene

Súbežne

100+

Hlavičky limitu požiadaviek

Každá odpoveď API obsahuje hlavičky, vďaka ktorým sledujete čerpanie voči svojmu SLA v reálnom čase.

X-Certificate-RateLimit-Limit, maximálny počet požiadaviek povolený v okne
X-Certificate-RateLimit-Remaining, počet zostávajúcich požiadaviek v aktuálnom okne
X-Certificate-RateLimit-Reset, unixová časová pečiatka obnovenia limitu

Webhooky

Dostávajte podpísané notifikácie v reálnom čase pri vydaní certifikátu aj pri dôležitých udalostiach na účte. Koncové body webhookov nastavíte a overíte vo svojom paneli.

Podporované udalosti

certificate.issued, certifikát bol úspešne opečatený a vydaný
certificate.failed, certifikáciu sa nepodarilo dokončiť
bulk.completed, všetky certifikáty v dávke sú opečatené
bulk.partial, časť certifikátov v dávke je opečatená
subscription.usage, blížite sa k limitu požiadaviek alebo k hranici kvóty

Bezpečnosť webhookov

Každý obsah webhooku je podpísaný algoritmom HMAC-SHA256 pomocou vášho tajného kľúča webhooku. Pred spracovaním overte hlavičku X-Certificate-Signature, aby ste potvrdili pravosť a neporušenosť.

Ukážka obsahu webhooku

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

Pripravení stavať na certifikovaných údajoch?

Vytvorte si certifikovaný vývojársky účet a začnite už dnes zapájať do svojich aplikácií oficiálne údaje o vozidlách kryté SLA.

Získať kľúč API Kontaktovať obchod