Prova Gratuita

Documentazione

Documentazione API CVReaderPro

Automatizza l'analisi, l'abbinamento e la generazione di CV per un reclutamento efficiente e conforme al GDPR.

Funzionalità chiave

FunzionalitàDescrizioneMetodo di consegna
Analisi CV (Parsing)Estrai dati strutturati (competenze, esperienza, istruzione, ecc.) da un file CV.Sincrona (Risposta API)
Abbinamento CV/Offerta di LavoroConfronta i CV con le tue offerte di lavoro per trovare i migliori candidati.API o Webhook
Generazione di CVGenera CV standard o anonimizzati secondo il modello aziendale.Webhook o Email

1. Analisi CV (Parsing)

Estrai dati strutturati da file CV (PDF, DOCX, ecc.).

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

  • Headers:
    • Authorization: ApiKey LA_TUA_CHIAVE_API
    • Accept: application/json (predefinito) o application/xml
  • Body (multipart/form-data):
    • file: File CV (PDF, DOCX, TXT, ecc.)
    • parserType: "DEFAULT" (veloce) o "ADVANCED" (preciso, raccomandato)
curl -X POST https://cvreader.fr/api/v1/parser   -H "Authorization: ApiKey LA_TUA_CHIAVE_API"   -F "file=@/path/to/cv.pdf"   -F "parserType=ADVANCED"

Risposta

Restituisce un JSON strutturato contenente informazioni personali (mascherabili), esperienze, istruzione, competenze e un ID CV univoco (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. Abbinamento CV/Offerta di Lavoro

Confronta i CV con le tue offerte di lavoro per identificare i migliori candidati.

  1. Fornisci un'API che restituisca le tue offerte nel formato JobItem.
  2. Registra l'URL della tua API in CVReaderPro (Impostazioni → Integrazioni API).

Endpoint API Sincrono

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

Headers:

Authorization: ApiKey LA_TUA_CHIAVE_API

Risposta

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

Endpoint API Asincrono

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

Headers:

Authorization: ApiKey LA_TUA_CHIAVE_API

Corpo

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

3. Generazione di CV (standard o anonimizzato)

Genera CV in formato PDF con anonimizzazione opzionale (mascheramento dati personali).

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

Come funziona

  1. Configura le regole di anonimizzazione nel tuo spazio sottoscrittore sotto "Impostazioni CV".

Headers:

Authorization: ApiKey LA_TUA_CHIAVE_API

Corpo


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

I CV generati vengono consegnati con un link per il download (downloadUrl) via webhook o email.

⚙ Configurazione Richiesta

  • Analisi: Nessuna configurazione richiesta.
  • Abbinamento: Implementa un'API JobItem e registra l'URL in CVReaderPro.
  • Generazione: Configura le regole di anonimizzazione e definisci un webhook o un'email.

📝 Casi d'Uso

1. Automatizzare il pre-screening dei candidati

  1. Analizza i CV ricevuti → Ottieni i valori 'resumeId'.
  2. Invia i 'resumeId' e 'offerId' a /api/jobs/queue.
  3. Ricevi i punteggi via webhook → Ordina i CV per 'totalScore'.

2. Reclutamento equo con CV anonimizzati

  1. Analizza i CV → Ottieni i 'resumeIds'.
  2. Configura l'anonimizzazione in 'Impostazioni CV' (nascondi nome, foto, contatti).

Gestione degli Errori

HTTPCausaSoluzione
400Richiesta malformataControlla il formato del corpo.
401Chiave API non validaControlla l'intestazione 'Authorization'.
404Risorsa non trovataControlla 'resumeId'/'jobId'.
429Troppe richiesteRiduci la frequenza o contatta l'assistenza.

Best Practices

  • Testa nell'ambiente sandbox prima di passare alla produzione.
  • Anonimizza sistematicamente i CV per i ruoli sensibili.
  • Monitora i tuoi webhook/email per i risultati asincroni.
  • Archivia i CV originali in modo sicuro (GDPR).

Supporto

Hai bisogno di aiuto? Contattaci.