Notificação de candidatura | Catho Desenvolvedores
Notificação de candidatura
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
As APIs seguem o mesmo modelo da API de cadastro de vagas, que você pode conhecer mais aqui.
Como funciona o callback
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
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,
"candidato": {
"href": "https://api.catho.com.br/v2/vagas/{vagaId}/candidatos/{candidatoId}-{perfilId}"
9 Operacional
/vagas/{id}/candidatos-perfil Lista todos os candidados relacionados com a vaga.
/vagas/{id}/candidatos/{candidato_id}-{perfil_id} Lista dados do canditado à vaga.
/vagas/{id}/candidatos/{candidato_id}-{perfil_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}-{perfil_id} e uma vez que o recrutador tenha interesse no candidato, deve ser utilizado o recurso /vagas/{id}/candidatos/{candidato_id}-{perfil_id}/contatos para visualizar os seus dados de contato.