Teste Grátis

Documentação

Documentação da API CVReaderPro

Automatize a análise, correspondência e geração de CV para recrutamento eficiente e em conformidade com o GDPR.

Características Principais

CaracterísticaDescriçãoMétodo de Entrega
Análise de CurrículoExtraia dados estruturados (habilidades, experiência, educação, etc.) de um CV/Currículo.Síncrono (Resposta da API)
Correspondência CV/Oferta de EmpregoCompare Currículos com suas ofertas de emprego para encontrar os melhores candidatos.API ou Webhook
Geração de CurrículoGere currículos padrão ou anonimizados de acordo com o modelo da sua empresa.Webhook ou Email

1. Análise de Currículo

Extraia dados estruturados de arquivos de CV/Currículo (PDF, DOCX, etc.).

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

  • Headers:
    • Authorization: ApiKey SUA_CHAVE_API
    • Accept: application/json (padrão) ou application/xml
  • Body (multipart/form-data):
    • file: Arquivo de CV/Currículo (PDF, DOCX, TXT, etc.)
    • parserType: "PADRÃO" (rápido) ou "AVANÇADO" (preciso, recomendado)
curl -X POST https://cvreader.fr/api/v1/parser   -H "Authorization: ApiKey SUA_CHAVE_API"   -F "file=@/path/to/cv.pdf"   -F "parserType=ADVANCED"

Resposta

Retorna um JSON estruturado incluindo informações pessoais (mascaráveis), experiências, educação, habilidades e um ID de Currículo ú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. Correspondência CV/Oferta de Emprego

Compare Currículos com suas ofertas de emprego para identificar os melhores candidatos.

  1. Forneça uma API que retorne suas ofertas de emprego no formato JobItem.
  2. Registre sua URL de API no CVReaderPro (Configurações → Integrações de API).

Endpoint de API Síncrono

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

Headers:

Authorization: ApiKey SUA_CHAVE_API

Resposta

{
  [
      {
        "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 Assíncrono

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

Headers:

Authorization: ApiKey SUA_CHAVE_API

Corpo

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

3. Geração de Currículo (Padrão ou Anonimizado)

Gere currículos em formato PDF com anonimização opcional (mascaramento de dados pessoais).

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

Como Funciona

  1. Configure regras de anonimização em sua área de assinante em "Configurações de CV".

Headers:

Authorization: ApiKey SUA_CHAVE_API

Corpo


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

Currículos gerados são entregues com um link de download (downloadUrl) via webhook ou email.

🔧 Configuração Necessária

  • Análise: Nenhuma configuração necessária.
  • Correspondência: Implemente uma API JobItem e registre a URL no CVReaderPro.
  • Geração: Configure regras de anonimização e defina um webhook ou email.

📝 Casos de Uso

1. Automatize a Pré-seleção de Candidatos

  1. Analise CVs recebidos → Obtenha valores 'resumeId'.
  2. Envie 'resumeId' e 'offerId' para /api/jobs/queue.
  3. Receba pontuações via webhook → Classifique CVs por 'totalScore'.

2. Contratação Justa com CVs Anonimizados

  1. Analise CVs → Obtenha 'resumeIds'.
  2. Configure anonimização em 'Configurações de CV' (mascarar nome, foto, contato).

Gerenciamento de Erros

HTTPCausaSolução
400Solicitação MalformadaVerifique o formato do corpo.
401Chave de API InválidaVerifique o cabeçalho 'Authorization'.
404Recurso Não EncontradoVerifique 'resumeId'/'jobId'.
429Muitas SolicitaçõesReduza a frequência ou entre em contato com o suporte.

Melhores Práticas

  • Teste no ambiente de sandbox antes de ir para produção.
  • Anonimize sistematicamente CVs para funções sensíveis.
  • Monitore seus webhooks/emails para resultados assíncronos.
  • Arquive com segurança CVs originais (GDPR).

Suporte

Precisa de ajuda? Contate-nos.