Adresse de l'API https://france-verification.com/api/v1

Vérifications

Une vérification (check, identifiant chk_...) est l'analyse d'un document. Ces routes les lisent une par une, les listent, donnent leur rapport PDF et les suppriment.

Lire une vérification

GET /api/v1/checks/{id}

curl "https://france-verification.com/api/v1/checks/chk_52817?detail=full" \
  -H "Authorization: Bearer $FV_API_KEY"

Réponse : l'objet Check.

Lister les vérifications

GET /api/v1/checks

Avec une clé live, la liste contient toutes les vérifications du compte, y compris celles faites sur le site. Avec une clé test, seulement les vérifications fictives des envois de test. Tri : de la plus récente à la plus ancienne.

{
  "data": [ { "id": "chk_52817", "status": "completed", "verdict": "SUSPECT", "...": "..." } ],
  "pagination": { "page": 1, "per_page": 50, "total": 128, "has_more": true }
}

Tant que has_more vaut true, demandez la page suivante.

Télécharger le rapport PDF

GET /api/v1/checks/{id}/report.pdf

Le même rapport que sur le site, prêt à archiver ou à transmettre. Disponible quand la vérification est completed (le champ report_url de l'objet donne l'adresse exacte).

curl -o rapport.pdf https://france-verification.com/api/v1/checks/chk_52817/report.pdf \
  -H "Authorization: Bearer $FV_API_KEY"

Supprimer une vérification

DELETE /api/v1/checks/{id}

Efface tout de suite le fichier envoyé, son aperçu, l'analyse et le journal technique. Réponse : 204 No Content. La suppression est définitive.

Sans suppression de votre part, les fichiers envoyés sont effacés automatiquement au bout de 7 jours ; le résultat de l'analyse, lui, reste consultable.