Kostenlos testen

Dokumentation

CVReaderPro Dokumentations-API

Automatisieren Sie die Lebenslaufanalyse, das Matching und die Generierung fĂŒr eine effiziente und DSGVO-konforme Personalbeschaffung.

Hauptfunktionen

FunktionBeschreibungLiefermethode
Lebenslauf-Analyse (Parsing)Extrahieren Sie strukturierte Daten (FĂ€higkeiten, Erfahrung, Bildung usw.) aus einem Lebenslauf.Synchron (API-Antwort)
Lebenslauf/Stellenangebot-MatchingVergleichen Sie LebenslÀufe mit Ihren Stellenangeboten, um die besten Kandidaten zu finden.API oder Webhook
Lebenslauf-GenerierungGenerieren Sie Standard- oder anonymisierte LebenslĂ€ufe gemĂ€ĂŸ der Vorlage Ihres Unternehmens.Webhook oder E-Mail

1. Lebenslauf-Analyse (Parsing)

Extrahieren Sie strukturierte Daten aus Lebenslaufdateien (PDF, DOCX usw.).

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

  • Headers:
    • Authorization: ApiKey IHR_API_SCHLÜSSEL
    • Accept: application/json (Standard) oder application/xml
  • Body (multipart/form-data):
    • file: Lebenslaufdatei (PDF, DOCX, TXT usw.)
    • parserType: "DEFAULT" (schnell) oder "ADVANCED" (prĂ€zise, empfohlen)
curl -X POST https://cvreader.fr/api/v1/parser   -H "Authorization: ApiKey IHR_API_SCHLÜSSEL"   -F "file=@/path/to/cv.pdf"   -F "parserType=ADVANCED"

Antwort

Gibt ein strukturiertes JSON zurĂŒck, das persönliche Informationen (maskierbar), Erfahrungen, Bildung, FĂ€higkeiten und eine eindeutige Lebenslauf-ID (resumeId) enthĂ€lt.

{
  "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. Lebenslauf/Stellenangebot-Matching

Vergleichen Sie LebenslÀufe mit Ihren Stellenangeboten, um die besten Kandidaten zu identifizieren.

  1. Stellen Sie eine API bereit, die Ihre Stellenangebote im JobItem-Format zurĂŒckgibt.
  2. Registrieren Sie Ihre API-URL in CVReaderPro (Einstellungen → API-Integrationen).

Synchroner API-Endpunkt

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

Headers:

Authorization: ApiKey IHR_API_SCHLÜSSEL

Antwort

{
  [
      {
        "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": []
      }
   ]
}

Asynchroner API-Endpunkt

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

Headers:

Authorization: ApiKey IHR_API_SCHLÜSSEL

Body

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

3. Lebenslauf-Generierung (Standard oder Anonymisiert)

Generieren Sie LebenslÀufe im PDF-Format mit optionaler Anonymisierung (Maskierung persönlicher Daten).

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

So Funktioniert Es

  1. Konfigurieren Sie die Anonymisierungsregeln in Ihrem Abonnentenbereich unter „Lebenslauf-Einstellungen“.

Headers:

Authorization: ApiKey IHR_API_SCHLÜSSEL

Body


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

Generierte LebenslÀufe werden mit einem Download-Link (downloadUrl) per Webhook oder E-Mail geliefert.

🔧 Erforderliche Konfiguration

  • Analyse: Keine Konfiguration erforderlich.
  • Matching: Implementieren Sie eine JobItem-API und registrieren Sie die URL in CVReaderPro.
  • Generierung: Konfigurieren Sie Anonymisierungsregeln und definieren Sie einen Webhook oder eine E-Mail.

📝 AnwendungsfĂ€lle

1. Automatisierung der Kandidaten-Vorselektion

  1. Analysieren Sie die erhaltenen LebenslĂ€ufe → Erhalten Sie die 'resumeId'-Werte.
  2. Senden Sie 'resumeId' und 'offerId' an /api/jobs/queue.
  3. Empfangen Sie Scores per Webhook → Sortieren Sie LebenslĂ€ufe nach 'totalScore'.

2. Faires Recruiting mit Anonymisierten LebenslÀufen

  1. Analysieren Sie LebenslĂ€ufe → Erhalten Sie die 'resumeIds'.
  2. Konfigurieren Sie die Anonymisierung in 'Lebenslauf-Einstellungen' (Name, Foto, Kontakt maskieren).

Fehlerverwaltung

HTTPUrsacheLösung
400Fehlerhafte AnfrageÜberprĂŒfen Sie das Body-Format.
401UngĂŒltiger API-SchlĂŒsselÜberprĂŒfen Sie den 'Authorization'-Header.
404Ressource nicht gefundenÜberprĂŒfen Sie 'resumeId'/'jobId'.
429Zu viele AnfragenReduzieren Sie die Frequenz oder kontaktieren Sie den Support.

Best Practices

  • Testen Sie in der Sandbox-Umgebung, bevor Sie zur Produktion ĂŒbergehen.
  • Anonymisieren Sie LebenslĂ€ufe fĂŒr sensible Rollen systematisch.
  • Überwachen Sie Ihre Webhooks/E-Mails auf asynchrone Ergebnisse.
  • Archivieren Sie Original-LebenslĂ€ufe sicher (DSGVO).

Support

Benötigen Sie Hilfe? Kontaktieren Sie uns .