Tanúsított adat API

Tanúsított járműadat-API fejlesztőknek

Építsen tanúsított, auditálásra kész járműtörténeti adatokat az alkalmazásába RESTful API-nkon keresztül. Több mint 900 hivatalos nyilvántartásból és több mint 1 milliárd hitelesített bejegyzésből, 45+ országból, 99,95% rendelkezésre állási SLA mellett.

https://api.autocertif.com/v1

Kezdés Végpontok megtekintése

Gyors kezdés

Szerezze meg az API-kulcsát

Regisztráljon tanúsított üzleti fiókot, és hozza létre az API-kulcsát a vezérlőpultról. Megfelelőségi teszteléshez sandbox kulcsok is elérhetők, kérésdíj nélkül.

Indítsa el az első hívást

Hitelesítsen az API-kulcsával és a tanúsítványkulcsával, majd küldje el az első kérését bármelyik végpontra. Kezdje a jármű-azonosító végponttal az azonnali, forrásjelölt válaszért.

Kapja meg az eredményt

Strukturált JSON-t kap tanúsított járműadatokkal, forrásmegjelöléssel és minden mezőnél hitelesítési időbélyeggel. Az eredményt tetszés szerint dolgozza fel, jelenítse meg vagy archiválja.

Hitelesítés

Minden API-kérés két hitelesítő adattal azonosít: egy Bearer tokennel az Authorization fejlécben és az X-Certificate-Key fejléccel. A kulcsokat a tanúsított üzleti vezérlőpultján adhatja ki, cserélheti és vonhatja vissza, teljes hozzáférési naplózással a megfelelőség érdekében.

Példakérés

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"

Őrizze biztonságban a kulcsait! Soha ne tegye elérhetővé az API-kulcsát vagy az X-Certificate-Key értékét kliensoldali kódban. Tárolja őket környezeti változókban, és a hívásokat szerveroldali proxyn keresztül vezesse, hogy a hitelesítő adatok és az auditnapló biztonságban maradjanak.

Végpontok

A tanúsított adat API öt alapvégpontot kínál: tanúsított jelentés kérése, tanúsítvány lekérése, tanúsítási státusz követése, kötegelt tanúsítás és VIN-azonosság feloldása. Minden tanúsítvány hamisításbiztos pecsétet, forrásmegjelölést és certified_at időbélyeget hordoz.

POST/v1/certificates

Tanúsítvány kérése

Tanúsított járműjelentés kérése VIN vagy rendszám alapján. Minden adatpont a hivatalos forrásáig visszakövethető, lepecsételve és időbélyegezve.

Paraméterek

Név	Típus	Kötelező	Leírás
`vin`	string	Feltételes	17 karakteres járműazonosító szám. Kötelező, kivéve ha a license_plate meg van adva.
`license_plate`	string	Feltételes	Forgalmi rendszám. Kötelező, kivéve ha a vin meg van adva.
`country`	string	Igen	A forgalomba helyezés ISO országkódja, például FR
`depth`	string	Nem	Tanúsítás mélysége: standard (alapértelmezett) vagy full

Példakérés

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}

Tanúsítvány lekérése

Korábban kiadott tanúsítvány lekérése az azonosítója alapján, a pecséttel, az ellenőrzésekkel és a megbízhatósági pontszámmal együtt.

Paraméterek

Név	Típus	Kötelező	Leírás
`certificate_id`	string	Igen	A jelentés kérésekor visszaadott tanúsítványazonosító (útvonalparaméter)

Példakérés

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

Tanúsítvány státusza

A tanúsítvány feldolgozási és tanúsítási állapotának lekérdezése, amíg a hivatalos források ellenőrzése zajlik.

Paraméterek

Név	Típus	Kötelező	Leírás
`certificate_id`	string	Igen	A vizsgálandó tanúsítvány azonosítója (útvonalparaméter)

Példakérés

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

Kötegelt tanúsítványok

Azonosítók kötegének beküldése tanúsításra egyetlen hívással. Minden tanúsítvány önállóan kap pecsétet, és külön-külön lekérhető vagy nyomon követhető.

Paraméterek

Név	Típus	Kötelező	Leírás
`identifiers`	array	Igen	VIN- vagy rendszám-karakterláncok tömbje (kérésenként legfeljebb 100)
`country`	string	Igen	A kötegre alkalmazott ISO országkód, például FR
`depth`	string	Nem	Minden elemre alkalmazott tanúsítási mélység: standard (alapértelmezett) vagy full

Példakérés

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

Jármű azonossága

VIN dekódolása hivatalos gyártói nyilvántartások alapján, a márka, a modell, az évjárat és a tanúsított műszaki adatok visszaadásával, teljes tanúsítvány kiadása nélkül.

Paraméterek

Név	Típus	Kötelező	Leírás
`vin`	string	Igen	17 karakteres járműazonosító szám (útvonalparaméter)
`include_specs`	boolean	Nem	A teljes tanúsított műszaki adatlap belefoglalása

Példakérés

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

Válaszformátum

Minden tanúsítvány egységes JSON-objektumként érkezik: egyedi certificate_id, hitelesítő pecsét, a dekódolt jármű, a tanúsított ellenőrzések, egy megbízhatósági pontszám és a kérés körülményeit dokumentáló metaadatok.

JSON-válasz

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

Válaszmezők

certificate_idA kiadott tanúsítvány egyedi azonosítója, cert_ előtaggal

vinA tanúsított járműazonosító szám

certified_atISO 8601 időbélyeg, amikor a tanúsítvány pecsétet kapott

sealHamisításbiztos hitelesítő pecsét az azonosítójával (seal_ előtaggal) és a valid jelzővel

vehicleA dekódolt jármű azonossága: márka, modell és évjárat

checks.mileageKilométeróra-állás a mértékegységgel és a tanúsított ellenőrzési státusszal

checks.accidentsA tanúsított baleseti bejegyzések száma

checks.theftHivatalos bűnüldözési adatbázisokkal ellenőrzött lopási státusz: none vagy flagged

checks.titleA hivatalos nyilvántartás alapján tanúsított okmánystátusz: clean vagy branded

official_sourcesA tanúsítványhoz összevetett hivatalos adatforrások száma

confidence_scoreTanúsítási megbízhatóság 0-tól 10-ig terjedő skálán

metaA kérés körülményei: a forgalomba helyezés országa és a tanúsítás mélysége

Hibakezelés

Az API a szokásos HTTP-státuszkódokat használja. Minden hiba leíró üzenettel és egy detail mezővel tér vissza, amely kérésazonosítót tartalmaz a hibakereséshez és az audithoz.

Kód	Üzenet	Leírás
400	Hibás kérés	A kérés törzse vagy paraméterei hibásak, vagy hiányoznak a kötelező mezők.
401	Nincs hitelesítve	Az API-kulcs hiányzik, érvénytelen, vagy vissza lett vonva.
403	Tiltott	Az API-kulcsnak nincs jogosultsága ehhez a végponthoz vagy erőforráshoz.
404	Nem található	A kért erőforrás (tanúsítvány, jármű) nem található.
429	Túl sok kérés	Túllépte a kéréskorlátot. Nézze meg az X-Certificate-RateLimit fejléceket, és próbálja újra a visszaállási ablak után.
500	Szerverhiba	Belső hiba történt. Küldje újra a kérést, vagy forduljon az ügyfélszolgálathoz, ha a hiba tartós.

Példa hibaválasz

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

Kéréskorlátok

Az API-kérések korlátozása előfizetési szintenként történik, mindegyiket szerződéses SLA szabályozza. Az aktuális korlátfelhasználást minden hívás válaszfejléce jelenti.

Kezdő

Kérés / perc

Kérés / nap

1,000

Egyidejű

Növekvő

Kérés / perc

300

Kérés / nap

10,000

Egyidejű

Vállalati

Kérés / perc

1,000+

Kérés / nap

Korlátlan

Egyidejű

100+

Kéréskorlát-fejlécek

Minden API-válasz tartalmaz fejléceket, hogy valós időben követhesse a felhasználást az SLA-hoz mérten.

X-Certificate-RateLimit-Limit, ablakonként engedélyezett maximális kérésszám
X-Certificate-RateLimit-Remaining, az aktuális ablakban hátralévő kérések száma
X-Certificate-RateLimit-Reset, Unix időbélyeg a kéréskorlát visszaállásáról

Webhookok

Kapjon valós idejű, aláírt értesítéseket, amikor egy tanúsítvány kiadásra kerül, vagy fontos fiókesemény történik. A webhook-végpontokat a vezérlőpultról állíthatja be és ellenőrizheti.

Támogatott események

certificate.issued, egy tanúsítvány pecsétet kapott és sikeresen kiadásra került
certificate.failed, a tanúsítást nem sikerült befejezni
bulk.completed, a köteg minden tanúsítványa pecsétet kapott
bulk.partial, a köteg egyes tanúsítványai kaptak pecsétet
subscription.usage, közeledik a kéréskorlát vagy a kvótaküszöb

Webhook-biztonság

Minden webhook-üzenetet HMAC-SHA256 algoritmussal írunk alá a webhook-titkával. Feldolgozás előtt ellenőrizze az X-Certificate-Signature fejlécet a hitelesség és a sértetlenség megerősítéséhez.

Példa webhook-üzenet

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

Készen áll tanúsított adatokra építeni?

Hozza létre tanúsított fejlesztői fiókját, és kezdje el még ma hivatalos, SLA-val fedezett járműadatok integrálását az alkalmazásaiba.

API-kulcs igénylése Kapcsolat az értékesítéssel