API de données véhicules certifiées pour développeurs

Authentification

Chaque requête API est authentifiée par deux identifiants : un token Bearer dans l'en-tête Authorization et votre en-tête X-Certificate-Key. Les clés sont émises, renouvelées et révoquées depuis votre tableau de bord professionnel certifié, avec une journalisation complète des accès à des fins de conformité.

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"

Points d'acces

L'API de données certifiées expose cinq endpoints principaux : demander un rapport certifié, récupérer un certificat, suivre le statut de certification, lancer des certifications par lots et résoudre l'identité d'un VIN. Chaque certificat porte un sceau infalsifiable, l'attribution des sources et un horodatage certified_at.

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

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

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"

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

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

Format de reponse

Chaque certificat est renvoyé sous forme d'objet JSON cohérent : un certificate_id unique, un sceau de vérification, le véhicule décodé, les vérifications certifiées, un score de confiance et des métadonnées documentant le contexte de la requête.

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

Champs de reponse

Gestion des erreurs

L'API utilise les codes de statut HTTP standard. Chaque erreur renvoie un message descriptif et un champ de détail comportant un identifiant de requête pour faciliter le débogage et l'audit.

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

Limites de debit

Les requêtes API sont limitées en débit selon votre forfait, chacun régi par un SLA contractuel. L'utilisation des limites est indiquée dans les en-têtes de réponse de chaque appel.

Webhooks

Recevez des notifications signées en temps réel lorsqu'un certificat est émis ou lorsque des événements importants surviennent sur le compte. Configurez et vérifiez les endpoints webhook depuis votre tableau de bord.

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