API REST

Des requêtes DGT pour des portefeuilles de milliers de véhicules.

Intégrez les requêtes de votre stock ou flotte par lots de plaques. Suivez chaque demande, récupérez le résumé JSON après analyse et téléchargez le PDF officiel lorsqu’il est disponible.

Demander l’accès à l’API

Un contrat conçu pour l’intégration

Accès par entreprise

Tokens Bearer avec droits définis et révocation depuis le portail entreprise.

Résumé JSON et PDF

Le détail du rapport expose 17 champs du véhicule après analyse et l’accès au PDF disponible. Les résultats peuvent être nuls pendant le traitement.

Lots asynchrones

POST /reports/batch accepte un tableau plates et renvoie 202. Chaque lot respecte la limite configurée et se traite en arrière-plan.

Idempotence et suivi

Idempotency-Key identifie vos demandes. Consultez ensuite leur état, leur progression et leur résultat avec GET.

/v1

Endpoints principaux

API REST versionnée sous /api/v1, avec authentification par token, limites et modèle d’erreurs documenté.

Authentification

Un token Bearer est lié à une entreprise, avec des droits qui limitent les opérations disponibles. Révoquez un identifiant depuis le portail sans affecter les autres.

Authorization: Bearer <token>

reports	Commandez un rapport DGT, listez-les, lisez-en un, téléchargez son PDF.
reports/batch	Soumettez de nombreuses plaques d’un coup ; la charge s’exécute en dehors de la requête.
usage	Solde, plan et grand livre des mouvements.
vehicles	Votre flotte : facultatif, puisque commander un rapport enregistre déjà son véhicule.
locations · departments · subsidiaries · batches	Comment la flotte est organisée.

Exemple de demande de rapport

curl -X POST https://veriflota.es/api/v1/reports \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"plate":"1234BCD"}'

Réponse initiale : traitement en attente

{
  "id": "01M0ANQ0DFADGVM5PV26ZYV3YX",
  "plate": "1234BCD",
  "status": "placed",
  "progress": "queued",
  "requester": { "type": "api_credential", "name": null },
  "placedAt": "2026-08-19T09:14:22+00:00",
  "settledAt": null,
  "outcome": { "returnCode": null, "documentAvailable": false },
  "vehicle": null
}

Modèle d’erreurs

Des erreurs JSON cohérentes, avec des codes machine stables, mappés depuis les exceptions internes.

{
  "error": {
    "code": "insufficient_report_balance",
    "message": "Not enough reports left on this account.",
    "details": { "needed": 5, "available": 2, "shortfall": 3 }
  }
}

unauthenticatedinsufficient_scopevalidation_failedinsufficient_report_balancereport_already_in_flightidempotency_key_reusedrate_limited

Référence complète de l’API

Tous les endpoints, corps de requête, champs de réponse et codes d’erreur, générés à partir de l’API elle-même. Connectez-vous pour la lire ; si vous n’avez pas encore de compte, demandez d’abord un accès.

Ouvrir la référence

Prêt à intégrer ?

Décrivez votre volume de demandes et vos besoins d’intégration. Nous vous aidons à préparer l’accès pour votre entreprise.

Demander l’accès à l’API