Prueba Gratuita

Documentación

Documentación API CVReaderPro

Automatiza el análisis, la comparación y la generación de CVs para una contratación eficiente y conforme al RGPD.

Características clave

CaracterísticaDescripciónMétodo de entrega
Análisis de CV (Parsing)Extrae datos estructurados (habilidades, experiencia, educación, etc.) de un archivo de CV.Síncrona (Respuesta API)
Comparación CV/Oferta de EmpleoCompara CVs con tus ofertas de trabajo para encontrar los mejores candidatos.API o Webhook
Generación de CVsGenera CVs estándar o anonimizados según el modelo de tu empresa.Webhook o Email

1. Análisis de CV (Parsing)

Extrae datos estructurados de archivos de CV (PDF, DOCX, etc.).

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

  • Headers:
    • Authorization: ApiKey TU_CLAVE_API
    • Accept: application/json (por defecto) o application/xml
  • Body (multipart/form-data):
    • file: Archivo CV (PDF, DOCX, TXT, etc.)
    • parserType: "DEFAULT" (rápido) o "ADVANCED" (preciso, recomendado)
curl -X POST https://cvreader.fr/api/v1/parser   -H "Authorization: ApiKey TU_CLAVE_API"   -F "file=@/path/to/cv.pdf"   -F "parserType=ADVANCED"

Respuesta

Devuelve un JSON estructurado que incluye información personal (enmascarable), experiencias, educación, habilidades y un ID de CV único (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. Comparación CV/Oferta de Empleo

Compara CVs con tus ofertas de trabajo para identificar los mejores candidatos.

  1. Proporciona una API que devuelva tus ofertas en formato JobItem.
  2. Registra la URL de tu API en CVReaderPro (Configuración → Integraciones API).

Endpoint de API Síncrono

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

Headers:

Authorization: ApiKey TU_CLAVE_API

Respuesta

{
  [
      {
        "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 de API Asíncrono

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

Headers:

Authorization: ApiKey TU_CLAVE_API

Cuerpo

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

3. Generación de CVs (estándar o anonimizado)

Genera CVs en formato PDF con anonimización opcional (enmascaramiento de datos personales).

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

Cómo funciona

  1. Configura las reglas de anonimización en tu espacio de suscripción bajo "Configuración de CV".

Headers:

Authorization: ApiKey TU_CLAVE_API

Cuerpo


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

Los CVs generados se entregan con un enlace de descarga (downloadUrl) por webhook o email.

⚙ Configuración Requerida

  • Análisis: No se requiere configuración.
  • Comparación: Implementa una API JobItem y registra la URL en CVReaderPro.
  • Generación: Configura las reglas de anonimización y define un webhook o un email.

📝 Casos de Uso

1. Automatizar la preselección de candidatos

  1. Analiza los CVs recibidos → Obtén los valores 'resumeId'.
  2. Envía los 'resumeId' y 'offerId' a /api/jobs/queue.
  3. Recibe las puntuaciones vía webhook → Ordena los CVs por 'totalScore'.

2. Contratación equitativa con CVs anonimizados

  1. Analiza los CVs → Obtén los 'resumeIds'.
  2. Configura la anonimización en 'Configuración de CV' (ocultar nombre, foto, contacto).

Manejo de Errores

HTTPCausaSolución
400Solicitud mal formadaVerifica el formato del cuerpo.
401Clave API inválidaVerifica el encabezado 'Authorization'.
404Recurso no encontradoVerifica 'resumeId'/'jobId'.
429Demasiadas solicitudesReduce la frecuencia o contacta al soporte.

Mejores Prácticas

  • Prueba en el entorno de pruebas (sandbox) antes de pasar a producción.
  • Anonimiza sistemáticamente los CVs para roles sensibles.
  • Monitoriza tus webhooks/emails para los resultados asíncronos.
  • Archiva los CVs originales de manera segura (RGPD).

Soporte

¿Necesitas ayuda? Contáctanos.