Sertifioidun datan API

Sertifioidun ajoneuvodatan API kehittäjille

Integroi sertifioitu, auditointivalmis ajoneuvohistoria sovellukseesi REST-rajapintamme kautta. Tiedot on koottu yli 900 virallisesta rekisteristä ja yli miljardista todennetusta merkinnästä yli 45 maassa, ja niiden takana on 99,95 %:n käytettävyyslupaus (SLA).

https://api.autocertif.com/v1

Aloita Katso päätepisteet

Pika-aloitus

Hanki API-avaimesi

Rekisteröidy sertifioidun yritystilin käyttäjäksi ja luo API-avaimesi hallintanäkymästä. Hiekkalaatikkoavaimet ovat saatavilla vaatimustenmukaisuustestaukseen ilman kutsuveloituksia.

Tee ensimmäinen kutsusi

Todenna itsesi API-avaimellasi ja sertifikaattiavaimellasi ja lähetä sitten ensimmäinen pyyntösi mihin tahansa päätepisteeseen. Aloita ajoneuvon tunnistepäätepisteestä, niin saat välittömän ja lähteisiin jäljitetyn vastauksen.

Vastaanota tulokset

Saat jäsennellyn JSON-vastauksen, jossa on sertifioitu ajoneuvodata, lähdeviite ja todennuksen aikaleima jokaisessa kentässä. Jäsennä, näytä tai arkistoi tulokset tarpeesi mukaan.

Todennus

Jokainen API-pyyntö todennetaan kahdella tunnisteella: Authorization-otsakkeen Bearer-tunnuksella ja X-Certificate-Key-otsakkeella. Avaimet luodaan, kierrätetään ja mitätöidään sertifioidusta yritysnäkymästäsi, ja kaikki käyttö lokitetaan vaatimustenmukaisuutta varten.

Esimerkkipyyntö

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"

Säilytä avaimesi turvassa! Älä koskaan paljasta API-avaintasi tai X-Certificate-Key-avainta selainpuolen koodissa. Säilytä ne ympäristömuuttujissa ja ohjaa kutsut palvelinpuolen välityspalvelimen kautta, jotta tunnisteesi ja kirjausketjusi pysyvät turvassa.

Päätepisteet

Sertifioidun datan API tarjoaa viisi keskeistä päätepistettä: sertifioidun raportin pyytäminen, sertifikaatin nouto, sertifioinnin tilan seuranta, massasertifiointi ja VIN-tunnisteen selvitys. Jokaisessa sertifikaatissa on väärentämisen paljastava sinetti, lähdeviite ja certified_at-aikaleima.

POST/v1/certificates

Pyydä sertifikaatti

Pyydä sertifioitu ajoneuvoraportti VIN-numerolla tai rekisterinumerolla. Jokainen tieto jäljitetään viralliseen lähteeseensä, sinetöidään ja aikaleimataan.

Parametrit

Nimi	Tyyppi	Pakollinen	Kuvaus
`vin`	string	Ehdollinen	17-merkkinen ajoneuvon valmistenumero (VIN). Pakollinen, ellei license_plate ole annettu.
`license_plate`	string	Ehdollinen	Rekisterinumero. Pakollinen, ellei vin ole annettu.
`country`	string	Kyllä	Rekisteröintimaan ISO-maakoodi, esimerkiksi FR
`depth`	string	Ei	Sertifioinnin syvyys: standard (oletus) tai full

Esimerkkipyyntö

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}

Nouda sertifikaatti

Nouda aiemmin myönnetty sertifikaatti sen tunnisteella, mukaan lukien sinetti, tarkistukset ja luotettavuuspisteet.

Parametrit

Nimi	Tyyppi	Pakollinen	Kuvaus
`certificate_id`	string	Kyllä	Sertifikaatin tunniste, joka palautettiin raporttia pyydettäessä (polkuparametri)

Esimerkkipyyntö

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

Sertifikaatin tila

Tarkista sertifikaatin käsittelyn ja sertifioinnin tila, kun sen virallisia lähteitä todennetaan.

Parametrit

Nimi	Tyyppi	Pakollinen	Kuvaus
`certificate_id`	string	Kyllä	Tarkasteltavan sertifikaatin tunniste (polkuparametri)

Esimerkkipyyntö

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

Massasertifiointi

Lähetä erä tunnisteita sertifioitavaksi yhdellä kutsulla. Jokainen sertifikaatti sinetöidään erikseen, ja sen voi noutaa tai sen tilaa seurata yksitellen.

Parametrit

Nimi	Tyyppi	Pakollinen	Kuvaus
`identifiers`	array	Kyllä	Taulukko VIN- tai rekisterinumeromerkkijonoja (enintään 100 per pyyntö)
`country`	string	Kyllä	Erään sovellettava ISO-maakoodi, esimerkiksi FR
`depth`	string	Ei	Jokaiseen kohteeseen sovellettava sertifioinnin syvyys: standard (oletus) tai full

Esimerkkipyyntö

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

Ajoneuvon tunnistetiedot

Tulkitse VIN virallisia valmistajarekistereitä vasten ja saat merkin, mallin, vuosimallin ja sertifioidut tekniset tiedot ilman täyden sertifikaatin myöntämistä.

Parametrit

Nimi	Tyyppi	Pakollinen	Kuvaus
`vin`	string	Kyllä	17-merkkinen ajoneuvon valmistenumero (polkuparametri)
`include_specs`	boolean	Ei	Sisällytä täydelliset sertifioidut tekniset tiedot

Esimerkkipyyntö

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

Vastausmuoto

Jokainen sertifikaatti palautetaan yhdenmukaisena JSON-objektina: yksilöivä certificate_id, todennussinetti, tulkitut ajoneuvotiedot, sertifioidut tarkistukset, luotettavuuspisteet sekä metatiedot, jotka dokumentoivat pyynnön kontekstin.

JSON-vastaus

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

Vastauksen kentät

certificate_idMyönnetyn sertifikaatin yksilöivä tunniste, etuliitteenä cert_

vinSertifioitu ajoneuvon valmistenumero (VIN)

certified_atISO 8601 -aikaleima, jolloin sertifikaatti sinetöitiin

sealVäärentämisen paljastava todennussinetti tunnisteineen (etuliite seal_) ja valid-lippuineen

vehicleTulkitut ajoneuvon tunnistetiedot: merkki, malli ja vuosimalli

checks.mileageMatkamittarin lukema yksikköineen ja sertifioitu todennuksen tila

checks.accidentsSertifioitujen kolarimerkintöjen määrä

checks.theftVarkaustila todennettuna virallisia poliisitietokantoja vasten: none tai flagged

checks.titleRekisteritietojen tila sertifioituna virallista rekisteriä vasten: clean tai branded

official_sourcesTähän sertifikaattiin ristiintarkistettujen virallisten tietolähteiden kokonaismäärä

confidence_scoreSertifioinnin luotettavuus asteikolla 0–10

metaPyynnön konteksti: rekisteröintimaa ja sertifioinnin syvyys

Virheiden käsittely

Rajapinta käyttää vakiomuotoisia HTTP-tilakoodeja. Jokainen virhe palauttaa kuvaavan viestin ja detail-kentän, jossa on pyynnön tunniste vianselvitystä ja auditointia varten.

Koodi	Viesti	Kuvaus
400	Virheellinen pyyntö	Pyynnön runko tai parametrit ovat virheellisiä tai pakollisia kenttiä puuttuu.
401	Ei valtuutettu	API-avain puuttuu, on virheellinen tai se on mitätöity.
403	Kielletty	API-avaimella ei ole oikeutta tähän päätepisteeseen tai resurssiin.
404	Ei löytynyt	Pyydettyä resurssia (sertifikaatti, ajoneuvo) ei löytynyt.
429	Liikaa pyyntöjä	Kutsuraja ylitetty. Tarkista X-Certificate-RateLimit-otsakkeet ja yritä uudelleen nollausikkunan jälkeen.
500	Palvelinvirhe	Tapahtui sisäinen virhe. Yritä pyyntöä uudelleen tai ota yhteyttä tukeen, jos ongelma jatkuu.

Esimerkki virhevastauksesta

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

Kutsurajat

API-pyyntöjä rajoitetaan tilaustason mukaan, ja kutakin tasoa koskee sopimuksellinen SLA. Rajan senhetkinen käyttö ilmoitetaan jokaisen kutsun vastausotsakkeissa.

Starter

Pyyntöä/min

Pyyntöä/vrk

1,000

Rinnakkaisia

Growth

Pyyntöä/min

300

Pyyntöä/vrk

10,000

Rinnakkaisia

Enterprise

Pyyntöä/min

1,000+

Pyyntöä/vrk

Rajaton

Rinnakkaisia

100+

Kutsurajan otsakkeet

Jokainen API-vastaus sisältää otsakkeet, joiden avulla seuraat käyttöä SLA:tasi vasten reaaliajassa.

X-Certificate-RateLimit-Limit, sallittujen pyyntöjen enimmäismäärä aikaikkunassa
X-Certificate-RateLimit-Remaining, jäljellä olevat pyynnöt nykyisessä aikaikkunassa
X-Certificate-RateLimit-Reset, Unix-aikaleima, jolloin kutsuraja nollautuu

Webhookit

Vastaanota reaaliaikaisia, allekirjoitettuja ilmoituksia, kun sertifikaatti myönnetään tai kun tililläsi tapahtuu jotain tärkeää. Määritä ja todenna webhook-päätepisteet hallintanäkymästäsi.

Tuetut tapahtumat

certificate.issued, sertifikaatti sinetöitiin ja myönnettiin onnistuneesti
certificate.failed, sertifiointia ei voitu saattaa loppuun
bulk.completed, kaikki erän sertifikaatit on sinetöity
bulk.partial, osa erän sertifikaateista on sinetöity
subscription.usage, kutsuraja tai kiintiöraja lähestyy

Webhookien tietoturva

Jokainen webhook-kuorma allekirjoitetaan HMAC-SHA256-menetelmällä webhook-salaisuudellasi. Todenna X-Certificate-Signature-otsake varmistaaksesi aitouden ja eheyden ennen käsittelyä.

Esimerkki webhook-kuormasta

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

Valmis rakentamaan sertifioidun datan varaan?

Luo sertifioitu kehittäjätilisi ja aloita virallisen, SLA:n takaaman ajoneuvodatan integrointi sovelluksiisi jo tänään.

Hanki API-avaimesi Ota yhteyttä myyntiin