API de date certificate

API de date auto certificate pentru dezvoltatori

Integrați în aplicația dvs. date de istoric auto certificate, pregătite pentru audit, prin API-ul nostru RESTful. Provin din peste 900 de registre oficiale și din peste 1 miliard de înregistrări verificate, din 45+ țări, susținute de un SLA de disponibilitate de 99,95%.

https://api.autocertif.com/v1

Începeți Vedeți endpointurile

Start rapid

Obțineți cheia API

Creați-vă un cont de firmă certificat și generați-vă cheia API din panoul de control. Cheile de sandbox sunt disponibile pentru testele de conformitate, fără a fi taxate.

Faceți primul apel

Autentificați-vă cu cheia API și cu cheia de certificat, apoi trimiteți prima cerere către oricare endpoint. Începeți cu endpointul de identitate a vehiculului, pentru un răspuns instantaneu, cu sursa trasabilă.

Primiți rezultatele

Primiți JSON structurat, cu date auto certificate, atribuirea sursei și o marcă temporală de verificare pentru fiecare câmp. Prelucrați, afișați sau arhivați rezultatele după cum aveți nevoie.

Autentificare

Fiecare cerere API se autentifică cu două credențiale: un token Bearer în antetul Authorization și antetul dvs. X-Certificate-Key. Cheile sunt emise, rotite și revocate din panoul dvs. de firmă certificat, cu jurnalizare completă a accesului, pentru conformitate.

Exemplu de cerere

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"

Păstrați-vă cheile în siguranță! Nu expuneți niciodată cheia API sau X-Certificate-Key în codul din browser. Păstrați-le în variabile de mediu și direcționați apelurile printr-un proxy pe server, ca să vă protejați credențialele și pista de audit.

Endpointuri

API-ul de date certificate expune cinci endpointuri principale: solicitarea unui raport certificat, descărcarea unui certificat, urmărirea stării certificării, certificări în masă și rezolvarea identității unui VIN. Fiecare certificat poartă un sigiliu inviolabil, atribuirea sursei și o marcă temporală certified_at.

POST/v1/certificates

Solicitare de certificat

Solicitați un raport auto certificat pornind de la un VIN sau de la un număr de înmatriculare. Fiecare informație este trasată până la sursa ei oficială, sigilată și marcată temporal.

Parametri

Nume	Tip	Obligatoriu	Descriere
`vin`	string	Condiționat	Numărul de identificare al vehiculului, de 17 caractere. Obligatoriu, cu excepția cazului în care se furnizează license_plate.
`license_plate`	string	Condiționat	Numărul de înmatriculare. Obligatoriu, cu excepția cazului în care se furnizează vin.
`country`	string	Da	Codul de țară ISO al înmatriculării, de exemplu FR
`depth`	string	Nu	Profunzimea certificării: standard (implicit) sau full

Exemplu de cerere

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}

Descărcare de certificat

Descărcați un certificat emis anterior, după identificatorul lui, împreună cu sigiliul, verificările și scorul de încredere.

Parametri

Nume	Tip	Obligatoriu	Descriere
`certificate_id`	string	Da	Identificatorul de certificat returnat la solicitarea raportului (parametru de cale)

Exemplu de cerere

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

Starea certificatului

Verificați starea de procesare și de certificare a unui certificat, în timp ce sursele lui oficiale sunt verificate.

Parametri

Nume	Tip	Obligatoriu	Descriere
`certificate_id`	string	Da	Identificatorul certificatului de inspectat (parametru de cale)

Exemplu de cerere

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

Certificate în masă

Trimiteți un lot de identificatori spre certificare, printr-un singur apel. Fiecare certificat este sigilat independent și poate fi descărcat sau urmărit separat.

Parametri

Nume	Tip	Obligatoriu	Descriere
`identifiers`	array	Da	Listă de VIN-uri sau de numere de înmatriculare (maximum 100 per cerere)
`country`	string	Da	Codul de țară ISO aplicat întregului lot, de exemplu FR
`depth`	string	Nu	Profunzimea certificării aplicată fiecărui element: standard (implicit) sau full

Exemplu de cerere

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

Identitatea vehiculului

Decodați un VIN în registrele oficiale ale producătorilor, ca să obțineți marca, modelul, anul și specificațiile certificate, fără a emite un certificat complet.

Parametri

Nume	Tip	Obligatoriu	Descriere
`vin`	string	Da	Numărul de identificare al vehiculului, de 17 caractere (parametru de cale)
`include_specs`	boolean	Nu	Include specificațiile tehnice certificate complete

Exemplu de cerere

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

Formatul răspunsului

Fiecare certificat este returnat ca un obiect JSON uniform: un certificate_id unic, un sigiliu de verificare, vehiculul decodat, verificările certificate, un scor de încredere și metadate care documentează contextul cererii.

Răspuns 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"
  }
}

Câmpurile răspunsului

certificate_idIdentificatorul unic al certificatului emis, cu prefixul cert_

vinNumărul de identificare al vehiculului, certificat

certified_atMarcă temporală ISO 8601 a momentului în care certificatul a fost sigilat

sealSigiliu de verificare inviolabil, cu id-ul lui (prefixat seal_) și indicatorul valid

vehicleIdentitatea decodată a vehiculului: marcă, model și an

checks.mileageIndicația de kilometraj, cu unitatea și starea de verificare certificată

checks.accidentsNumărul de evidențe de accident certificate

checks.theftStarea privind furtul, verificată în bazele de date oficiale ale poliției: none sau flagged

checks.titleStarea actelor, certificată în registrul oficial: clean sau branded

official_sourcesNumărul total de surse oficiale de date verificate încrucișat pentru acest certificat

confidence_scoreNivelul de încredere al certificării, pe o scară de la 0 la 10

metaContextul cererii: țara de înmatriculare și profunzimea certificării

Tratarea erorilor

API-ul folosește codurile de stare HTTP standard. Fiecare eroare returnează un mesaj descriptiv și un câmp detail cu un ID de cerere, util pentru depanare și audit.

Cod	Mesaj	Descriere
400	Bad Request	Corpul cererii sau parametrii sunt formatați greșit ori lipsesc câmpuri obligatorii.
401	Unauthorized	Cheia API lipsește, este invalidă sau a fost revocată.
403	Forbidden	Cheia API nu are permisiune pentru acest endpoint sau pentru această resursă.
404	Not Found	Resursa cerută (certificat, vehicul) nu a fost găsită.
429	Too Many Requests	Limita de rată a fost depășită. Consultați antetele X-Certificate-RateLimit și reîncercați după fereastra de resetare.
500	Server Error	A apărut o eroare internă. Reîncercați cererea sau contactați asistența dacă persistă.

Exemplu de răspuns de eroare

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

Limite de rată

Cererile către API sunt limitate în funcție de nivelul de abonament, fiecare guvernat de un SLA contractual. Consumul curent este raportat în antetele răspunsului la fiecare apel.

Starter

Cereri / min

Cereri / zi

1,000

Simultane

Growth

Cereri / min

300

Cereri / zi

10,000

Simultane

Enterprise

Cereri / min

1,000+

Cereri / zi

Nelimitat

Simultane

100+

Antetele de limitare a ratei

Fiecare răspuns al API-ului include antete, ca să vă puteți urmări consumul față de SLA în timp real.

X-Certificate-RateLimit-Limit, numărul maxim de cereri permise pe fereastră
X-Certificate-RateLimit-Remaining, cererile rămase în fereastra curentă
X-Certificate-RateLimit-Reset, marca temporală Unix la care se resetează limita

Webhookuri

Primiți notificări semnate, în timp real, când un certificat este emis sau când au loc evenimente importante pe cont. Configurați și verificați endpointurile de webhook din panoul dvs.

Evenimente acceptate

certificate.issued, un certificat a fost sigilat și emis cu succes
certificate.failed, certificarea nu a putut fi finalizată
bulk.completed, toate certificatele dintr-un lot sunt sigilate
bulk.partial, o parte dintre certificatele lotului sunt sigilate
subscription.usage, vă apropiați de limita de rată sau de pragul de cotă

Securitatea webhookurilor

Fiecare payload de webhook este semnat cu HMAC-SHA256, folosind secretul dvs. de webhook. Verificați antetul X-Certificate-Signature ca să confirmați autenticitatea și integritatea înainte de procesare.

Exemplu de payload de webhook

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

Gata să construiți pe date certificate?

Creați-vă contul de dezvoltator certificat și începeți chiar azi să integrați în aplicațiile dvs. date auto oficiale, susținute de un SLA.

Obțineți cheia API Contactați vânzările