Ler candidaturas
Atualizado
Hoje as candidaturas vivem na Orbit. Lê-las pela API está definido, não lançado. Enviá-las está: Receber candidaturas a partir da sua própria página de carreiras recebe uma candidatura a partir do seu próprio formulário e diz-lhe onde está o CV Virtual, e nada mais.
O que está previsto
- Registos estruturados de candidaturas para uma vaga, e uma candidatura específica por id: o CV estruturado do candidato tal como a vista de candidaturas da Orbit já o mostra, a pontuação de adequação e o estado de verificação de cada afirmação.
- A verificação é reportada com honestidade. Uma afirmação é
verifiedapenas quando uma pessoa identificada a confirmou,pendingenquanto uma confirmação estiver pendente, eunverifiednos restantes casos. A API nunca apresentará uma afirmação não verificada como outra coisa, e uma página que a mostre também não deve. - A sua própria base de consentimento. Dados de um candidato não são dados de uma vaga. Lê-los exige um âmbito próprio, e as condições em que uma conta pode guardá-los fora da Orbit fazem parte do trabalho, não de um detalhe posterior.
O que pode fazer hoje
Tudo o que um candidato faz depois de clicar no applyLink, ou depois de a sua própria página enviar a candidatura, é visível em Orbit → Candidaturas, incluindo de onde veio.
Pela API, GET /v1/applications/{applicationId} responde para as candidaturas que a sua conta enviou: se a candidatura se mantém, e onde está o CV Virtual (processing, staged, claimed, deleted ou failed). Nunca traz o CV, nem o nome nem o e-mail do candidato. É um estado para a página que o candidato está a ver, não o registo de que trata esta página.