Sertifikuotų duomenų API

Sertifikuotų automobilių duomenų API kūrėjams

Integruokite sertifikuotus, auditui parengtus automobilių istorijos duomenis į savo programą per REST API. Duomenys iš daugiau nei 900 oficialių registrų ir 1B+ patikrintų įrašų 45+ šalyse, užtikrinti 99,95 % veikimo laiko SLA.

https://api.autocertif.com/v1

Pradėti Peržiūrėti galinius taškus

Greita pradžia

Gaukite API raktą

Užsiregistruokite sertifikuotą verslo paskyrą ir sugeneruokite API raktą skydelyje. Bandymų aplinkos raktai prieinami atitikties testavimui be jokių užklausų mokesčių.

Atlikite pirmąją užklausą

Autentifikuokitės savo API ir sertifikato raktais, tada siųskite pirmąją užklausą bet kuriam galiniam taškui. Pradėkite nuo automobilio tapatybės galinio taško – gausite akimirksniu pateikiamą, šaltiniais atsekamą atsakymą.

Gaukite rezultatus

Gaukite struktūruotą JSON su sertifikuotais automobilio duomenimis, šaltinio nuoroda ir patikros laiko žyma prie kiekvieno lauko. Rezultatus apdorokite, rodykite arba archyvuokite, kaip jums reikia.

Autentifikavimas

Kiekviena API užklausa autentifikuojama dviem duomenimis: Bearer prieigos raktu Authorization antraštėje ir jūsų X-Certificate-Key antrašte. Raktai išduodami, keičiami ir atšaukiami sertifikuotame verslo skydelyje, o visa prieiga registruojama atitikties tikslais.

Užklausos pavyzdys

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"

Saugokite savo raktus! Niekada neatskleiskite savo API rakto ar X-Certificate-Key kliento pusės kode. Laikykite juos aplinkos kintamuosiuose ir siųskite užklausas per serverio pusės tarpinį serverį, kad prisijungimo duomenys ir audito pėdsakas liktų saugūs.

Galiniai taškai

Sertifikuotų duomenų API turi penkis pagrindinius galinius taškus: sertifikuotos ataskaitos užsakymą, sertifikato gavimą, sertifikavimo būsenos stebėjimą, masinį sertifikavimą ir VIN tapatybės nustatymą. Kiekvienas sertifikatas turi nuo klastojimo apsaugotą antspaudą, šaltinio nuorodą ir certified_at laiko žymą.

POST/v1/certificates

Užsakyti sertifikatą

Užsisakykite sertifikuotą automobilio ataskaitą pagal VIN arba valstybinį numerį. Kiekvienas duomuo atsekamas iki oficialaus šaltinio, antspauduojamas ir pažymimas laiko žyma.

Parametrai

Pavadinimas	Tipas	Privalomas	Aprašymas
`vin`	string	Sąlyginis	17 simbolių automobilio identifikavimo numeris. Privalomas, jei nenurodytas license_plate.
`license_plate`	string	Sąlyginis	Valstybinis numeris. Privalomas, jei nenurodytas vin.
`country`	string	Taip	Registracijos šalies ISO kodas, pavyzdžiui FR
`depth`	string	Ne	Sertifikavimo gylis: standard (numatytasis) arba full

Užklausos pavyzdys

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}

Gauti sertifikatą

Gaukite anksčiau išduotą sertifikatą pagal jo identifikatorių kartu su antspaudu, patikromis ir patikimumo balu.

Parametrai

Pavadinimas	Tipas	Privalomas	Aprašymas
`certificate_id`	string	Taip	Sertifikato identifikatorius, grąžintas užsakant ataskaitą (kelio parametras)

Užklausos pavyzdys

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

Sertifikato būsena

Patikrinkite sertifikato apdorojimo ir sertifikavimo būseną, kol tikrinami jo oficialūs šaltiniai.

Parametrai

Pavadinimas	Tipas	Privalomas	Aprašymas
`certificate_id`	string	Taip	Tikrinamo sertifikato identifikatorius (kelio parametras)

Užklausos pavyzdys

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

Masinis sertifikavimas

Pateikite identifikatorių paketą sertifikuoti viena užklausa. Kiekvienas sertifikatas antspauduojamas atskirai, jį galima gauti ar stebėti pavieniui.

Parametrai

Pavadinimas	Tipas	Privalomas	Aprašymas
`identifiers`	array	Taip	VIN arba valstybinių numerių eilučių masyvas (iki 100 vienoje užklausoje)
`country`	string	Taip	Visam paketui taikomas šalies ISO kodas, pavyzdžiui FR
`depth`	string	Ne	Kiekvienam elementui taikomas sertifikavimo gylis: standard (numatytasis) arba full

Užklausos pavyzdys

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

Automobilio tapatybė

Iššifruokite VIN pagal oficialius gamintojų registrus ir gaukite markę, modelį, metus bei sertifikuotą specifikaciją neišduodami viso sertifikato.

Parametrai

Pavadinimas	Tipas	Privalomas	Aprašymas
`vin`	string	Taip	17 simbolių automobilio identifikavimo numeris (kelio parametras)
`include_specs`	boolean	Ne	Įtraukti visą sertifikuotą techninę specifikaciją

Užklausos pavyzdys

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

Atsakymo formatas

Kiekvienas sertifikatas grąžinamas kaip vienodos sandaros JSON objektas: unikalus certificate_id, patikros antspaudas, iššifruotas automobilis, sertifikuotos patikros, patikimumo balas ir metaduomenys, aprašantys užklausos kontekstą.

JSON atsakymas

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

Atsakymo laukai

certificate_idUnikalus išduoto sertifikato identifikatorius su priešdėliu cert_

vinSertifikuotas automobilio identifikavimo numeris

certified_atISO 8601 laiko žyma, kada sertifikatas buvo antspauduotas

sealNuo klastojimo apsaugotas patikros antspaudas su id (priešdėlis seal_) ir valid žyma

vehicleIššifruota automobilio tapatybė: markė, modelis ir metai

checks.mileageOdometro rodmuo su matavimo vienetu ir sertifikuota patikros būsena

checks.accidentsSertifikuotų eismo įvykių įrašų skaičius

checks.theftVagystės būsena, patikrinta oficialiose teisėsaugos duomenų bazėse: none arba flagged

checks.titleTeisinio statuso būsena, sertifikuota pagal oficialų registrą: clean arba branded

official_sourcesBendras oficialių duomenų šaltinių, sutikrintų šiam sertifikatui, skaičius

confidence_scoreSertifikavimo patikimumas skalėje nuo 0 iki 10

metaUžklausos kontekstas: registracijos šalis ir sertifikavimo gylis

Klaidų apdorojimas

API naudoja standartinius HTTP būsenos kodus. Kiekviena klaida grąžina aiškinamąjį pranešimą ir detail lauką su užklausos ID, kad būtų lengviau derinti ir audituoti.

Kodas	Pranešimas	Aprašymas
400	Neteisinga užklausa	Užklausos turinys ar parametrai netinkamos formos arba trūksta privalomų laukų.
401	Neautorizuota	API raktas nenurodytas, neteisingas arba atšauktas.
403	Draudžiama	API raktas neturi teisių šiam galiniam taškui ar ištekliui.
404	Nerasta	Prašomas išteklius (sertifikatas, automobilis) nerastas.
429	Per daug užklausų	Viršyta užklausų riba. Patikrinkite X-Certificate-RateLimit antraštes ir bandykite dar kartą pasibaigus ribojimo langui.
500	Serverio klaida	Įvyko vidinė klaida. Pakartokite užklausą arba, jei ji kartojasi, kreipkitės į pagalbos komandą.

Klaidos atsakymo pavyzdys

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

Užklausų ribos

API užklausos ribojamos pagal prenumeratos pakopą, o kiekvienai jų galioja sutartinis SLA. Dabartinis ribos išnaudojimas nurodomas kiekvieno atsakymo antraštėse.

Pradžia

Užklausų / min.

Užklausų / d.

1,000

Vienu metu

Augimas

Užklausų / min.

300

Užklausų / d.

10,000

Vienu metu

Įmonėms

Užklausų / min.

1,000+

Užklausų / d.

Neribota

Vienu metu

100+

Užklausų ribos antraštės

Kiekviename API atsakyme pateikiamos antraštės, kad galėtumėte realiuoju laiku sekti naudojimą pagal savo SLA.

X-Certificate-RateLimit-Limit – didžiausias leidžiamas užklausų skaičius per langą
X-Certificate-RateLimit-Remaining – likusios užklausos einamajame lange
X-Certificate-RateLimit-Reset – Unix laiko žyma, kada riba atstatoma

Webhook'ai

Gaukite pasirašytus pranešimus realiuoju laiku, kai išduodamas sertifikatas ar įvyksta svarbūs paskyros įvykiai. Webhook galinius taškus konfigūruokite ir tikrinkite savo skydelyje.

Palaikomi įvykiai

certificate.issued – sertifikatas sėkmingai antspauduotas ir išduotas
certificate.failed – sertifikavimo nepavyko užbaigti
bulk.completed – visi paketo sertifikatai antspauduoti
bulk.partial – dalis paketo sertifikatų antspauduota
subscription.usage – artėjama prie užklausų ribos ar kvotos

Webhook saugumas

Kiekvienas webhook turinys pasirašomas HMAC-SHA256 algoritmu naudojant jūsų webhook slaptą raktą. Prieš apdorodami patikrinkite X-Certificate-Signature antraštę, kad įsitikintumėte autentiškumu ir vientisumu.

Webhook turinio pavyzdys

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

Pasiruošę kurti su sertifikuotais duomenimis?

Susikurkite sertifikuotą kūrėjo paskyrą ir jau šiandien pradėkite integruoti oficialius, SLA užtikrintus automobilių duomenis į savo programas.

Gauti API raktą Susisiekti su pardavimais