Essai Gratuit

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éDescriptionMé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'EmploiComparez les CVs avec vos offres d'emploi pour trouver les meilleurs candidats.API ou Webhook
Génération de CVGé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.

  1. Fournissez une API qui retourne vos offres au format JobItem.
  2. 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

  1. 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

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

2. Recrutement équitable avec CVs anonymisés

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

Gestion des erreurs

HTTPCauseSolution
400RequĂȘte mal formĂ©eVĂ©rifiez le format du corps.
401ClĂ© API invalideVĂ©rifiez l'en-tĂȘte 'Authorization'.
404Ressource non trouvéeVérifiez 'resumeId'/'jobId'.
429Trop de requĂȘtesRĂ©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.