API certifikovaných dat

API certifikovaných dat o vozidlech pro vývojáře

Napojte do své aplikace certifikovanou historii vozidel připravenou k auditu, a to přes naše RESTové API. Čerpáme z více než 900 oficiálních registrů a 1B+ ověřených záznamů ze 45+ zemí, se SLA dostupnosti 99,95 %.

https://api.autocertif.com/v1

Začít Zobrazit koncové body

Rychlý start

Získejte API klíč

Zaregistrujte si certifikovaný firemní účet a v nástěnce si vygenerujte API klíč. Pro testování shody jsou k dispozici sandboxové klíče, které se nezapočítávají do limitů.

Proveďte první volání

Autentizujte se svým API klíčem a certifikačním klíčem a odešlete první požadavek na libovolný koncový bod. Začněte koncovým bodem identity vozidla, který vrátí okamžitou odpověď s uvedením zdrojů.

Získejte výsledky

Obdržíte strukturovaný JSON s certifikovanými daty o vozidle, uvedením zdroje a časovým razítkem ověření u každého pole. Výsledky můžete zpracovat, zobrazit nebo archivovat podle potřeby.

Autentizace

Každý požadavek na API se autentizuje dvěma údaji: tokenem Bearer v hlavičce Authorization a vaší hlavičkou X-Certificate-Key. Klíče vydáváte, obměňujete i rušíte ve své certifikované firemní nástěnce, a to s úplným logováním přístupů kvůli shodě s předpisy.

Ukázkový požadavek

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"

Chraňte své klíče! Nikdy nevystavujte svůj API klíč ani X-Certificate-Key v kódu na straně klienta. Ukládejte je do proměnných prostředí a volání směrujte přes serverovou proxy, aby vaše přihlašovací údaje i auditní stopa zůstaly v bezpečí.

Koncové body

API certifikovaných dat nabízí pět základních koncových bodů: vyžádání certifikované zprávy, načtení certifikátu, sledování stavu certifikace, hromadnou certifikaci a zjištění identity podle VIN. Každý certifikát nese pečeť odolnou proti pozměnění, uvedení zdrojů a časové razítko certified_at.

POST/v1/certificates

Vyžádat certifikát

Vyžádejte certifikovanou zprávu o vozidle podle VIN nebo registrační značky. Každý údaj je dohledatelný ke svému oficiálnímu zdroji, opatřený pečetí a časovým razítkem.

Parametry

Název	Typ	Povinné	Popis
`vin`	string	Podmíněně	17místné identifikační číslo vozidla. Povinné, pokud není uveden license_plate.
`license_plate`	string	Podmíněně	Registrační značka. Povinná, pokud není uveden vin.
`country`	string	Ano	Kód země registrace podle ISO, například FR
`depth`	string	Ne	Hloubka certifikace: standard (výchozí) nebo full

Ukázkový požadavek

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číst certifikát

Načtěte dříve vydaný certifikát podle jeho identifikátoru, včetně pečeti, provedených kontrol a skóre důvěryhodnosti.

Parametry

Název	Typ	Povinné	Popis
`certificate_id`	string	Ano	Identifikátor certifikátu vrácený při vyžádání zprávy (parametr v cestě)

Ukázkový požadavek

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

Zjistěte stav zpracování a certifikace certifikátu v době, kdy se ověřují jeho oficiální zdroje.

Parametry

Název	Typ	Povinné	Popis
`certificate_id`	string	Ano	Identifikátor certifikátu, který chcete prověřit (parametr v cestě)

Ukázkový požadavek

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

Odešlete dávku identifikátorů k certifikaci jediným voláním. Každý certifikát dostane vlastní pečeť a lze jej načíst i sledovat samostatně.

Parametry

Název	Typ	Povinné	Popis
`identifiers`	array	Ano	Pole řetězců s VIN nebo registračními značkami (max. 100 na požadavek)
`country`	string	Ano	Kód země podle ISO použitý na celou dávku, například FR
`depth`	string	Ne	Hloubka certifikace použitá na každou položku: standard (výchozí) nebo full

Ukázkový požadavek

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 proti oficiálním registrům výrobců a získejte značku, model, rok výroby i certifikované technické údaje, aniž byste vydávali celý certifikát.

Parametry

Název	Typ	Povinné	Popis
`vin`	string	Ano	17místné identifikační číslo vozidla (parametr v cestě)
`include_specs`	boolean	Ne	Zahrnout kompletní certifikované technické údaje

Ukázkový požadavek

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 odpovědi

Každý certifikát se vrací jako jednotný objekt JSON: unikátní certificate_id, ověřovací pečeť, dekódované vozidlo, certifikované kontroly, skóre důvěryhodnosti a metadata popisující kontext požadavku.

Odpověď v 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"
  }
}

Pole odpovědi

certificate_idUnikátní identifikátor vydaného certifikátu s předponou cert_

vinCertifikované identifikační číslo vozidla

certified_atČasové razítko ISO 8601 určující, kdy byl certifikát opatřen pečetí

sealOvěřovací pečeť odolná proti pozměnění, s vlastním id (předpona seal_) a příznakem valid

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

checks.mileageStav tachometru s jednotkou a certifikovaným stavem ověření

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

checks.theftStav krádeže ověřený proti oficiálním policejním databázím: none nebo flagged

checks.titlePrávní stav dokladů certifikovaný proti oficiálnímu registru: clean nebo branded

official_sourcesCelkový počet oficiálních zdrojů dat porovnaných pro tento certifikát

confidence_scoreDůvěryhodnost certifikace na stupnici 0 až 10

metaKontext požadavku: země registrace a hloubka certifikace

Ošetření chyb

API používá standardní stavové kódy HTTP. Každá chyba vrací popisnou zprávu a pole detail s ID požadavku, což usnadňuje ladění i audit.

Kód	Zpráva	Popis
400	Chybný požadavek	Tělo požadavku nebo parametry jsou chybně zapsané, případně chybí povinná pole.
401	Neautorizováno	API klíč chybí, je neplatný, nebo byl zrušen.
403	Zakázáno	API klíč nemá oprávnění k tomuto koncovému bodu ani zdroji.
404	Nenalezeno	Požadovaný zdroj (certifikát, vozidlo) nebyl nalezen.
429	Příliš mnoho požadavků	Byl překročen limit požadavků. Zkontrolujte hlavičky X-Certificate-RateLimit a volání zopakujte po vynulování okna.
500	Chyba serveru	Došlo k vnitřní chybě. Zopakujte požadavek, a pokud potíž přetrvává, kontaktujte podporu.

Ukázka chybové odpovědi

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

Limity požadavků

Požadavky na API jsou omezeny podle stupně předplatného, přičemž každý se řídí smluvním SLA. Aktuální čerpání limitu najdete v hlavičkách odpovědi u každého volání.

Start

Požadavků / min

Požadavků / den

1,000

Souběžně

Růst

Požadavků / min

300

Požadavků / den

10,000

Souběžně

Enterprise

Požadavků / min

1,000+

Požadavků / den

Neomezeně

Souběžně

100+

Hlavičky limitu požadavků

Každá odpověď API obsahuje hlavičky, díky nimž sledujete čerpání vůči svému SLA v reálném čase.

X-Certificate-RateLimit-Limit, maximální počet požadavků povolený v jednom okně
X-Certificate-RateLimit-Remaining, počet požadavků zbývajících v aktuálním okně
X-Certificate-RateLimit-Reset, unixové časové razítko, kdy se limit vynuluje

Webhooky

Dostávejte podepsané notifikace v reálném čase, jakmile je vydán certifikát nebo nastane důležitá událost na účtu. Koncové body webhooků nastavíte a ověříte ve své nástěnce.

Podporované události

certificate.issued, certifikát byl opatřen pečetí a úspěšně vydán
certificate.failed, certifikaci se nepodařilo dokončit
bulk.completed, všechny certifikáty v dávce jsou opatřeny pečetí
bulk.partial, část certifikátů v dávce je opatřena pečetí
subscription.usage, blížíte se limitu požadavků nebo hranici kvóty

Zabezpečení webhooků

Každý payload webhooku je podepsán algoritmem HMAC-SHA256 pomocí vašeho tajného klíče. Před zpracováním ověřte hlavičku X-Certificate-Signature a potvrďte tak pravost i neporušenost dat.

Ukázka payloadu 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"
  }
}

Chcete stavět na certifikovaných datech?

Založte si certifikovaný vývojářský účet a začněte do svých aplikací hned dnes integrovat oficiální data o vozidlech krytá SLA.

Získat API klíč Kontaktovat obchod