Retorno dos candidatos da vaga

Visão Geral

As APIs de vagas são um conjunto de ferramentas que permitem às empresas integrarem seus sistemas de cadastro de vagas com a Catho, sem que haja necessidade de cadastrar a vaga no site manualmente. Nessa seção abordamos como as empresas também podem integrar as candidaturas recebidas em seus sistemas sem acessar o site, por meio de nossas APIs


Modelagem das APIs

As APIs seguem o mesmo modelo da API de cadastro de vagas, que você pode conhecer mais aqui


Como funciona o callback

  1. Ao postar uma vaga na Catho, usando nossa API, a empresa especifica um endereço de callback para ser notificada do recebimento de uma nova candidatura
  2. Quando alguém se candidatar à vaga no site da Catho, nós iremos fazer um POST para o endereço especificado com o seguinte payload:
{
    "vagaId": int,
    "candidatoId": string,
    "_links": {
        "candidato": {
            "href": "https://api.catho.com.br/v2/vagas/{vagaId}/candidatos/{candidatoId}"
        }
    }
}

Serviços disponíveis

Recurso Descrição
/vagas/{id}/candidatos Lista todos os candidados relacionados com a vaga.
/vagas/{id}/candidatos/{candidato_id} Lista dados do canditado à vaga.
/vagas/{id}/candidatos/{candidato_id}/contatos Lista dados de contato do candidado a vaga.

Dados de contato do candidato

Os dados de contato do candidato são a informação de mais valor para os recrutadores, mas precisam ser usados com cuidado para que nossos candidatos não sejam contatados indevidamente, portanto só devem ser consultados caso haja interesse do recrutador pelo candidato. O candidato deve ser exibido ao recrutador utilizando o recurso /vagas/{id}/candidatos/{candidato_id} e uma vez que o recrutador tenha interesse no candidato, deve ser utilizado o recurso /vagas/{id}/candidatos/{candidato_id}/contatos para visualizar os seus dados de contato.