API πιστοποιημένων δεδομένων

API πιστοποιημένων δεδομένων οχημάτων για προγραμματιστές

Ενσωματώστε πιστοποιημένα, ελέγξιμα δεδομένα ιστορικού οχημάτων στην εφαρμογή σας μέσω του RESTful API μας. Αντλούνται από περισσότερα από 900 επίσημα μητρώα και 1B+ επαληθευμένες εγγραφές σε 45+ χώρες, με SLA διαθεσιμότητας 99,95%.

https://api.autocertif.com/v1

Ξεκινήστε Δείτε τα endpoints

Γρήγορη εκκίνηση

Αποκτήστε το κλειδί API

Δημιουργήστε πιστοποιημένο επαγγελματικό λογαριασμό και εκδώστε το κλειδί API από τον πίνακα ελέγχου. Διατίθενται κλειδιά sandbox για δοκιμές συμμόρφωσης, χωρίς χρέωση κλήσεων.

Κάντε την πρώτη σας κλήση

Ταυτοποιηθείτε με το κλειδί API και το κλειδί πιστοποιητικού και στείλτε το πρώτο σας αίτημα σε οποιοδήποτε endpoint. Ξεκινήστε από το endpoint ταυτότητας οχήματος για άμεση απόκριση με αναφορά πηγών.

Λάβετε αποτελέσματα

Λάβετε δομημένο JSON με πιστοποιημένα δεδομένα οχήματος, αναφορά πηγής και χρονοσήμανση επαλήθευσης σε κάθε πεδίο. Επεξεργαστείτε, εμφανίστε ή αρχειοθετήστε τα αποτελέσματα όπως χρειάζεστε.

Ταυτοποίηση

Κάθε αίτημα προς το API ταυτοποιείται με δύο διαπιστευτήρια: ένα Bearer token στην κεφαλίδα Authorization και την κεφαλίδα X-Certificate-Key. Τα κλειδιά εκδίδονται, ανανεώνονται και ανακαλούνται από τον πιστοποιημένο επαγγελματικό πίνακα ελέγχου, με πλήρη καταγραφή προσβάσεων για λόγους συμμόρφωσης.

Παράδειγμα αιτήματος

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"

Κρατήστε τα κλειδιά σας ασφαλή! Μην εκθέτετε ποτέ το κλειδί API ή το X-Certificate-Key σε κώδικα που τρέχει στον client. Αποθηκεύστε τα σε μεταβλητές περιβάλλοντος και δρομολογήστε τις κλήσεις μέσω proxy στον διακομιστή, ώστε τα διαπιστευτήρια και το ιστορικό ελέγχου να παραμένουν ασφαλή.

Endpoints

Το API πιστοποιημένων δεδομένων προσφέρει πέντε βασικά endpoints: αίτημα πιστοποιημένης αναφοράς, ανάκτηση πιστοποιητικού, παρακολούθηση κατάστασης πιστοποίησης, μαζικές πιστοποιήσεις και ανάλυση ταυτότητας VIN. Κάθε πιστοποιητικό φέρει σφραγίδα προστασίας από αλλοιώσεις, αναφορά πηγών και χρονοσήμανση certified_at.

POST/v1/certificates

Αίτημα πιστοποιητικού

Ζητήστε πιστοποιημένη αναφορά οχήματος από VIN ή αριθμό πινακίδας. Κάθε στοιχείο συνδέεται με την επίσημη πηγή του, σφραγίζεται και λαμβάνει χρονοσήμανση.

Παράμετροι

Όνομα	Τύπος	Υποχρεωτικό	Περιγραφή
`vin`	string	Υπό όρους	Αριθμός αναγνώρισης οχήματος 17 χαρακτήρων. Υποχρεωτικός εκτός αν δοθεί license_plate.
`license_plate`	string	Υπό όρους	Αριθμός πινακίδας κυκλοφορίας. Υποχρεωτικός εκτός αν δοθεί vin.
`country`	string	Ναι	Κωδικός χώρας ταξινόμησης κατά ISO, για παράδειγμα FR
`depth`	string	Όχι	Βάθος πιστοποίησης: standard (προεπιλογή) ή full

Παράδειγμα αιτήματος

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}

Ανάκτηση πιστοποιητικού

Ανακτήστε ένα πιστοποιητικό που έχει ήδη εκδοθεί, με βάση το αναγνωριστικό του, μαζί με τη σφραγίδα, τους ελέγχους και τον δείκτη αξιοπιστίας του.

Παράμετροι

Όνομα	Τύπος	Υποχρεωτικό	Περιγραφή
`certificate_id`	string	Ναι	Αναγνωριστικό πιστοποιητικού που επιστράφηκε κατά το αίτημα της αναφοράς (παράμετρος διαδρομής)

Παράδειγμα αιτήματος

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

Κατάσταση πιστοποιητικού

Ελέγξτε την πορεία επεξεργασίας και πιστοποίησης ενός πιστοποιητικού όσο επαληθεύονται οι επίσημες πηγές του.

Παράμετροι

Όνομα	Τύπος	Υποχρεωτικό	Περιγραφή
`certificate_id`	string	Ναι	Αναγνωριστικό του πιστοποιητικού προς έλεγχο (παράμετρος διαδρομής)

Παράδειγμα αιτήματος

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

Μαζικά πιστοποιητικά

Υποβάλετε μια παρτίδα αναγνωριστικών για πιστοποίηση με μία κλήση. Κάθε πιστοποιητικό σφραγίζεται ανεξάρτητα και μπορεί να ανακτηθεί ή να παρακολουθηθεί χωριστά.

Παράμετροι

Όνομα	Τύπος	Υποχρεωτικό	Περιγραφή
`identifiers`	array	Ναι	Πίνακας συμβολοσειρών VIN ή αριθμών πινακίδας (έως 100 ανά αίτημα)
`country`	string	Ναι	Κωδικός χώρας κατά ISO που εφαρμόζεται στην παρτίδα, για παράδειγμα FR
`depth`	string	Όχι	Βάθος πιστοποίησης για κάθε στοιχείο: standard (προεπιλογή) ή full

Παράδειγμα αιτήματος

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

Ταυτότητα οχήματος

Αποκωδικοποιήστε ένα VIN μέσα από τα επίσημα μητρώα των κατασκευαστών και λάβετε μάρκα, μοντέλο, έτος και πιστοποιημένες προδιαγραφές, χωρίς έκδοση πλήρους πιστοποιητικού.

Παράμετροι

Όνομα	Τύπος	Υποχρεωτικό	Περιγραφή
`vin`	string	Ναι	Αριθμός αναγνώρισης οχήματος 17 χαρακτήρων (παράμετρος διαδρομής)
`include_specs`	boolean	Όχι	Να περιληφθούν οι πλήρεις πιστοποιημένες τεχνικές προδιαγραφές

Παράδειγμα αιτήματος

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

Μορφή απόκρισης

Κάθε πιστοποιητικό επιστρέφεται ως ενιαίο αντικείμενο JSON: ένα μοναδικό certificate_id, μια σφραγίδα επαλήθευσης, το αποκωδικοποιημένο όχημα, τους πιστοποιημένους ελέγχους, έναν δείκτη αξιοπιστίας και μεταδεδομένα που τεκμηριώνουν το πλαίσιο του αιτήματος.

Απόκριση 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"
  }
}

Πεδία απόκρισης

certificate_idΜοναδικό αναγνωριστικό του πιστοποιητικού που εκδόθηκε, με πρόθεμα cert_

vinΟ πιστοποιημένος αριθμός αναγνώρισης οχήματος

certified_atΧρονοσήμανση κατά ISO 8601 τη στιγμή σφράγισης του πιστοποιητικού

sealΣφραγίδα επαλήθευσης με προστασία από αλλοιώσεις, με το id της (πρόθεμα seal_) και την ένδειξη valid

vehicleΑποκωδικοποιημένη ταυτότητα οχήματος: μάρκα, μοντέλο και έτος

checks.mileageΈνδειξη χιλιομετρητή με μονάδα μέτρησης και πιστοποιημένη κατάσταση επαλήθευσης

checks.accidentsΑριθμός πιστοποιημένων καταγραφών ατυχημάτων

checks.theftΚατάσταση κλοπής επαληθευμένη μέσα από επίσημες αστυνομικές βάσεις δεδομένων: none ή flagged

checks.titleΚατάσταση τίτλου πιστοποιημένη μέσα από το επίσημο μητρώο: clean ή branded

official_sourcesΣυνολικός αριθμός επίσημων πηγών δεδομένων που διασταυρώθηκαν για το πιστοποιητικό

confidence_scoreΑξιοπιστία πιστοποίησης σε κλίμακα από 0 έως 10

metaΠλαίσιο αιτήματος: χώρα ταξινόμησης και βάθος πιστοποίησης

Διαχείριση σφαλμάτων

Το API χρησιμοποιεί τους τυπικούς κωδικούς κατάστασης HTTP. Κάθε σφάλμα επιστρέφει περιγραφικό μήνυμα και ένα πεδίο detail με το αναγνωριστικό του αιτήματος, για διευκόλυνση του debugging και του ελέγχου.

Κωδικός	Μήνυμα	Περιγραφή
400	Λανθασμένο αίτημα	Το σώμα ή οι παράμετροι του αιτήματος είναι λανθασμένα ή λείπουν υποχρεωτικά πεδία.
401	Μη εξουσιοδοτημένο	Το κλειδί API λείπει, δεν είναι έγκυρο ή έχει ανακληθεί.
403	Απαγορευμένο	Το κλειδί API δεν έχει δικαίωμα πρόσβασης σε αυτό το endpoint ή τον πόρο.
404	Δεν βρέθηκε	Ο ζητούμενος πόρος (πιστοποιητικό, όχημα) δεν βρέθηκε.
429	Υπερβολικά αιτήματα	Ξεπεράστηκε το όριο κλήσεων. Ελέγξτε τις κεφαλίδες X-Certificate-RateLimit και δοκιμάστε ξανά μετά την επαναφορά του παραθύρου.
500	Σφάλμα διακομιστή	Παρουσιάστηκε εσωτερικό σφάλμα. Επαναλάβετε το αίτημα ή επικοινωνήστε με την υποστήριξη αν επιμένει.

Παράδειγμα απόκρισης σφάλματος

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

Όρια κλήσεων

Τα αιτήματα προς το API περιορίζονται ανάλογα με το επίπεδο συνδρομής, καθένα από τα οποία διέπεται από συμβατικό SLA. Η τρέχουσα χρήση των ορίων αναφέρεται στις κεφαλίδες απόκρισης κάθε κλήσης.

Starter

Αιτήματα / λεπτό

Αιτήματα / ημέρα

1,000

Ταυτόχρονα

Growth

Αιτήματα / λεπτό

300

Αιτήματα / ημέρα

10,000

Ταυτόχρονα

Enterprise

Αιτήματα / λεπτό

1,000+

Αιτήματα / ημέρα

Απεριόριστα

Ταυτόχρονα

100+

Κεφαλίδες ορίων κλήσεων

Κάθε απόκριση του API περιλαμβάνει κεφαλίδες, ώστε να παρακολουθείτε τη χρήση σε σχέση με το SLA σας σε πραγματικό χρόνο.

X-Certificate-RateLimit-Limit, μέγιστος αριθμός επιτρεπόμενων αιτημάτων ανά παράθυρο
X-Certificate-RateLimit-Remaining, αιτήματα που απομένουν στο τρέχον παράθυρο
X-Certificate-RateLimit-Reset, χρονοσήμανση Unix της επαναφοράς του ορίου

Webhooks

Λάβετε υπογεγραμμένες ειδοποιήσεις σε πραγματικό χρόνο όταν εκδίδεται ένα πιστοποιητικό ή όταν συμβαίνουν σημαντικά γεγονότα στον λογαριασμό σας. Ρυθμίστε και επαληθεύστε τα endpoints webhook από τον πίνακα ελέγχου σας.

Υποστηριζόμενα γεγονότα

certificate.issued, ένα πιστοποιητικό σφραγίστηκε και εκδόθηκε με επιτυχία
certificate.failed, η πιστοποίηση δεν ολοκληρώθηκε
bulk.completed, όλα τα πιστοποιητικά μιας παρτίδας σφραγίστηκαν
bulk.partial, ορισμένα πιστοποιητικά μιας παρτίδας σφραγίστηκαν
subscription.usage, πλησιάζετε το όριο κλήσεων ή το όριο χρήσης

Ασφάλεια webhook

Κάθε payload webhook υπογράφεται με HMAC-SHA256 χρησιμοποιώντας το μυστικό κλειδί σας. Επαληθεύστε την κεφαλίδα X-Certificate-Signature για να επιβεβαιώσετε τη γνησιότητα και την ακεραιότητά του πριν το επεξεργαστείτε.

Παράδειγμα payload 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"
  }
}

Έτοιμοι να χτίσετε πάνω σε πιστοποιημένα δεδομένα;

Δημιουργήστε τον πιστοποιημένο λογαριασμό προγραμματιστή σας και αρχίστε σήμερα να ενσωματώνετε επίσημα δεδομένα οχημάτων, καλυμμένα από SLA, στις εφαρμογές σας.

Αποκτήστε κλειδί API Επικοινωνία με πωλήσεις