Documentation

Documentation API CVReaderPro

Automatisez l'analyse, l'appariement et la génération de CV pour un recrutement efficace et conforme au RGPD.

Fonctionnalités clés

Fonctionnalité	Description	Méthode de livraison
Analyse de CV (Parsing)	Extraire des données structurées (compétences, expérience, éducation, etc.) à partir d'un CV.	Synchrone (Réponse API)
Appariement CV/Offre d'Emploi	Comparez les CVs avec vos offres d'emploi pour trouver les meilleurs candidats.	API ou Webhook
Génération de CV	Générez des CVs standard ou anonymisés selon le modèle de votre entreprise.	Webhook ou Email

1. Analyse de CV (Parsing)

Extraire des données structurées à partir de fichiers CV (PDF, DOCX, etc.).

POST https://cvreader.fr/api/v1/parser

Headers:
- Authorization: ApiKey VOTRE_CLÉ_API
- Accept: application/json (par défaut) ou application/xml
Body (multipart/form-data):
- file: Fichier CV (PDF, DOCX, TXT, etc.)
- parserType: "DEFAULT" (rapide) ou "ADVANCED" (précis, recommandé)

curl -X POST https://cvreader.fr/api/v1/parser   -H "Authorization: ApiKey VOTRE_CLÉ_API"   -F "file=@/path/to/cv.pdf"   -F "parserType=ADVANCED"

Réponse

Retourne un JSON structuré incluant les informations personnelles (masquables), les expériences, l'éducation, les compétences et un ID de CV unique (resumeId).

{
  "resumeId": "c8cd44a0-d765-4d47-ba04-67903ef650e5",
  "documentType": "CV",
  "documentLanguage": "FR",
  "candidate": {
    "firstName": "Jean",
    "lastName": "Dupont"
  },
  "profile":"",
  "experienceLevel": "",
  "experiences": [],
  "educationLevel": "",
  "educations": [],
  "languages": [],
  "skills": [],
  "softSkills": [],
  "references": [],
  "hobbies": "",
  
}

2. Appariement CV/Offre d'Emploi

Comparez les CVs avec vos offres d'emploi pour identifier les meilleurs candidats.

Fournissez une API qui retourne vos offres au format JobItem.
Enregistrez l'URL de votre API dans CVReaderPro (Paramètres → Intégrations API).

Point de terminaison API synchrone

POST https://cvreader.fr/api/scores/jobs-for-resume/{resumeId}

Headers:

Authorization: ApiKey VOTRE_CLÉ_API

Réponse

{
  [
      {
        "id": "c561d0dd-4397-4a37-979f-87cf42bdb3a1",
        "jobId": "e918ab2f-d2f8-4890-b2d6-b049a76207a9",
        "candidateId": "96b029fc-568e-4e34-9e06-711216e92e22",
        "distance": "75.7km",
        "totalScore": 88.79,
        "profileScore": 0,
        "experienceScore": 6.65,
        "educationScore": 2.14,
        "languageScore": 25,
        "matchedKeywords": []
      }
   ]
}

Point de terminaison API asynchrone

POST https://cvreader.fr/api/jobs/queue

Headers:

Authorization: ApiKey VOTRE_CLÉ_API

Corps

[
  "offre-123",
  "offre-456"
]

3. Génération de CV (standard ou anonymisé)

Générez des CVs au format PDF avec anonymisation optionnelle (masquage des données personnelles).

POST https://cvreader.fr/api/resume-settings/format

Comment ça fonctionne

Configurez les règles d'anonymisation dans votre espace abonné sous "Paramètres du CV".

Headers:

Authorization: ApiKey VOTRE_CLÉ_API

Corps


  [
    "resume-data-uuid-1",
    "a10288d7-b4ad-4181-8a45-2b7af9671b7c",
    "parsed-resume-unique-id-3"
  ]

Les CVs générés sont livrés avec un lien de téléchargement (downloadUrl) par webhook ou email.

🔧 Configuration requise

Analyse: Aucune configuration requise.
Appariement: Implémentez une API JobItem et enregistrez l'URL dans CVReaderPro.
Génération: Configurez les règles d'anonymisation et définissez un webhook ou un email.

📝 Cas d'utilisation

1. Automatiser le pré-filtrage des candidats

Analysez les CVs reçus → Obtenez les valeurs 'resumeId'.
Envoyez les 'resumeId' et 'offerId' à /api/jobs/queue.
Recevez les scores via webhook → Triez les CVs par 'totalScore'.

2. Recrutement équitable avec CVs anonymisés

Analysez les CVs → Obtenez les 'resumeIds'.
Configurez l'anonymisation dans 'Paramètres du CV' (masquer nom, photo, contact).

Gestion des erreurs

HTTP	Cause	Solution
400	Requête mal formée	Vérifiez le format du corps.
401	Clé API invalide	Vérifiez l'en-tête 'Authorization'.
404	Ressource non trouvée	Vérifiez 'resumeId'/'jobId'.
429	Trop de requêtes	Réduisez la fréquence ou contactez le support.

Meilleures pratiques

Testez dans l'environnement de bac à sable (sandbox) avant de passer à la production.
Anonymisez systématiquement les CVs pour les rôles sensibles.
Surveillez vos webhooks/emails pour les résultats asynchrones.
Archivez les CVs originaux de manière sécurisée (RGPD).

Support

Besoin d'aide? Contactez-nous.