Sertificēto datu API

Sertificētu auto datu API izstrādātājiem

Integrējiet sertificētus, auditam gatavus auto vēstures datus savā lietotnē ar mūsu RESTful API. Dati no vairāk nekā 900 oficiāliem reģistriem un 1B+ pārbaudītiem ierakstiem 45+ valstīs, ar 99,95 % darbspējas SLA.

https://api.autocertif.com/v1

Sākt darbu Skatīt galapunktus

Ātrais sākums

Saņemiet savu API atslēgu

Reģistrējiet sertificētu biznesa kontu un izveidojiet API atslēgu savā panelī. Atbilstības testēšanai pieejamas testa vides atslēgas, par kurām netiek ieturēta maksa.

Veiciet pirmo izsaukumu

Autentificējieties ar savu API atslēgu un sertifikāta atslēgu, tad nosūtiet pirmo pieprasījumu jebkuram galapunktam. Sāciet ar auto identitātes galapunktu, lai saņemtu tūlītēju atbildi ar norādītiem avotiem.

Saņemiet rezultātus

Saņemiet strukturētu JSON ar sertificētiem auto datiem, avota norādi un pārbaudes laika zīmogu katram laukam. Apstrādājiet, attēlojiet vai arhivējiet rezultātus pēc vajadzības.

Autentifikācija

Katrs API pieprasījums tiek autentificēts ar diviem akreditācijas datiem: Bearer marķieri Authorization galvenē un Jūsu X-Certificate-Key galveni. Atslēgas izsniedzat, nomaināt un atsaucat savā sertificētajā biznesa panelī, un piekļuve tiek pilnībā reģistrēta atbilstības nodrošināšanai.

Pieprasījuma piemērs

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"

Glabājiet savas atslēgas drošībā! Nekad neatklājiet savu API atslēgu vai X-Certificate-Key klienta puses kodā. Glabājiet tās vides mainīgajos un novirziet izsaukumus caur servera puses starpniekserveri, lai Jūsu akreditācijas dati un auditācijas pieraksti būtu drošībā.

Galapunkti

Sertificēto datu API piedāvā piecus pamata galapunktus: pieprasīt sertificētu pārskatu, saņemt sertifikātu, sekot sertificēšanas statusam, veikt masveida sertificēšanu un noteikt auto identitāti pēc VIN. Katram sertifikātam ir pret viltojumiem aizsargāts zīmogs, avota norāde un certified_at laika zīmogs.

POST/v1/certificates

Pieprasīt sertifikātu

Pieprasiet sertificētu auto pārskatu pēc VIN vai reģistrācijas numura. Katrs datu punkts ir izsekojams līdz oficiālajam avotam, apzīmogots un ar laika zīmogu.

Parametri

Nosaukums	Tips	Obligāts	Apraksts
`vin`	string	Nosacīti	17 zīmju auto identifikācijas numurs. Obligāts, ja nav norādīts license_plate.
`license_plate`	string	Nosacīti	Reģistrācijas numurs. Obligāts, ja nav norādīts vin.
`country`	string	Jā	Reģistrācijas valsts ISO kods, piemēram, FR
`depth`	string	Nē	Sertificēšanas dziļums: standard (noklusējums) vai full

Pieprasījuma piemērs

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}

Saņemt sertifikātu

Saņemiet iepriekš izsniegtu sertifikātu pēc tā identifikatora, ieskaitot zīmogu, veiktās pārbaudes un ticamības vērtējumu.

Parametri

Nosaukums	Tips	Obligāts	Apraksts
`certificate_id`	string	Jā	Sertifikāta identifikators, kas atgriezts, pieprasot pārskatu (ceļa parametrs)

Pieprasījuma piemērs

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

Sertifikāta statuss

Pārbaudiet sertifikāta apstrādes un sertificēšanas statusu, kamēr tiek verificēti tā oficiālie avoti.

Parametri

Nosaukums	Tips	Obligāts	Apraksts
`certificate_id`	string	Jā	Aplūkojamā sertifikāta identifikators (ceļa parametrs)

Pieprasījuma piemērs

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

Masveida sertifikāti

Iesniedziet identifikatoru kopu sertificēšanai vienā izsaukumā. Katrs sertifikāts tiek apzīmogots atsevišķi, un to var saņemt vai izsekot individuāli.

Parametri

Nosaukums	Tips	Obligāts	Apraksts
`identifiers`	array	Jā	VIN vai reģistrācijas numuru virkņu masīvs (ne vairāk kā 100 vienā pieprasījumā)
`country`	string	Jā	Visai kopai piemērotais valsts ISO kods, piemēram, FR
`depth`	string	Nē	Katram ierakstam piemērotais sertificēšanas dziļums: standard (noklusējums) vai full

Pieprasījuma piemērs

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

Auto identitāte

Atšifrējiet VIN oficiālajos ražotāju reģistros, lai iegūtu marku, modeli, gadu un sertificētas specifikācijas, neizsniedzot pilnu sertifikātu.

Parametri

Nosaukums	Tips	Obligāts	Apraksts
`vin`	string	Jā	17 zīmju auto identifikācijas numurs (ceļa parametrs)
`include_specs`	boolean	Nē	Iekļaut pilnas sertificētās tehniskās specifikācijas

Pieprasījuma piemērs

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

Atbildes formāts

Katrs sertifikāts tiek atgriezts kā vienveidīgs JSON objekts: unikāls certificate_id, verifikācijas zīmogs, atšifrētie auto dati, sertificētās pārbaudes, ticamības vērtējums un metadati par pieprasījuma kontekstu.

JSON atbilde

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

Atbildes lauki

certificate_idIzsniegtā sertifikāta unikālais identifikators ar priedēkli cert_

vinSertificētais auto identifikācijas numurs

certified_atISO 8601 laika zīmogs, kad sertifikāts tika apzīmogots

sealPret viltojumiem aizsargāts verifikācijas zīmogs ar savu id (priedēklis seal_) un valid karodziņu

vehicleAtšifrētā auto identitāte: marka, modelis un gads

checks.mileageOdometra rādījums ar mērvienību un sertificētu pārbaudes statusu

checks.accidentsSertificēto negadījumu ierakstu skaits

checks.theftZādzības statuss, pārbaudīts oficiālajās tiesībaizsardzības datubāzēs: none vai flagged

checks.titleReģistrācijas atzīmju statuss, sertificēts oficiālajā reģistrā: clean vai branded

official_sourcesKopējais oficiālo datu avotu skaits, kas savstarpēji pārbaudīti šim sertifikātam

confidence_scoreSertificēšanas ticamība skalā no 0 līdz 10

metaPieprasījuma konteksts: reģistrācijas valsts un sertificēšanas dziļums

Kļūdu apstrāde

API izmanto standarta HTTP statusa kodus. Katra kļūda atgriež skaidrojošu ziņojumu un detail lauku ar pieprasījuma ID, kas noder atkļūdošanai un auditam.

Kods	Ziņojums	Apraksts
400	Nederīgs pieprasījums	Pieprasījuma saturs vai parametri ir nepareizi noformēti, vai arī trūkst obligāto lauku.
401	Nav autorizēts	API atslēga nav norādīta, nav derīga vai ir atsaukta.
403	Piekļuve liegta	API atslēgai nav atļaujas piekļūt šim galapunktam vai resursam.
404	Nav atrasts	Pieprasītais resurss (sertifikāts, auto) netika atrasts.
429	Pārāk daudz pieprasījumu	Pārsniegts pieprasījumu limits. Pārbaudiet X-Certificate-RateLimit galvenes un mēģiniet vēlreiz pēc limita atjaunošanas.
500	Servera kļūda	Radusies iekšēja kļūda. Atkārtojiet pieprasījumu vai, ja kļūda saglabājas, sazinieties ar atbalsta komandu.

Kļūdas atbildes piemērs

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

Pieprasījumu limiti

API pieprasījumu limiti ir atkarīgi no abonementa līmeņa, un katru no tiem nosaka līgumiskais SLA. Pašreizējais limita izlietojums tiek norādīts katra izsaukuma atbildes galvenēs.

Sākums

Pieprasījumi / min

Pieprasījumi / dienā

1,000

Vienlaicīgi

Izaugsme

Pieprasījumi / min

300

Pieprasījumi / dienā

10,000

Vienlaicīgi

Korporatīvais

Pieprasījumi / min

1,000+

Pieprasījumi / dienā

Neierobežoti

Vienlaicīgi

100+

Pieprasījumu limita galvenes

Katra API atbilde ietver galvenes, lai Jūs varētu reāllaikā sekot izlietojumam attiecībā pret savu SLA.

X-Certificate-RateLimit-Limit, maksimālais atļautais pieprasījumu skaits vienā periodā
X-Certificate-RateLimit-Remaining, atlikušie pieprasījumi pašreizējā periodā
X-Certificate-RateLimit-Reset, Unix laika zīmogs, kad limits tiek atjaunots

Webhooks

Saņemiet parakstītus paziņojumus reāllaikā, tiklīdz tiek izsniegts sertifikāts vai notiek svarīgi konta notikumi. Webhook galapunktus konfigurējiet un pārbaudiet savā panelī.

Atbalstītie notikumi

certificate.issued, sertifikāts sekmīgi apzīmogots un izsniegts
certificate.failed, sertificēšanu neizdevās pabeigt
bulk.completed, visi kopas sertifikāti ir apzīmogoti
bulk.partial, daļa kopas sertifikātu ir apzīmogoti
subscription.usage, tuvojas pieprasījumu limita vai kvotas slieksnis

Webhook drošība

Katrs webhook sūtījums tiek parakstīts ar HMAC-SHA256, izmantojot Jūsu webhook noslēpumu. Pirms apstrādes pārbaudiet X-Certificate-Signature galveni, lai apliecinātu autentiskumu un integritāti.

Webhook sūtījuma piemērs

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

Gatavs veidot risinājumus uz sertificētiem datiem?

Izveidojiet sertificētu izstrādātāja kontu un jau šodien sāciet savās lietotnēs integrēt oficiālus auto datus ar SLA garantiju.

Saņemt API atslēgu Sazināties ar pārdošanas nodaļu