Coloque avaliação verificada dentro do sistema que você já usa.
A Hirovia é uma camada de medição, não mais um lugar para fazer login. Quatro formas de conectá-la — de uma regra de e-mail que leva dois minutos a uma integração REST completa com o seu ATS.
Pegue uma chave de sandbox — grátis Ver a referência da API
Candidatos de sandbox nunca são cobrados · sem cartão para começar
Quatro formas de conectar, em ordem de esforço.
Coloque em cópia ou encaminhe as candidaturas para o seu endereço de entrada privado. A Hirovia lê o remetente, identifica a vaga pelo assunto, guarda o currículo e convida o candidato. Uma regra de encaminhamento no Gmail ou no Outlook é a integração inteira.
Ideal para: times cujas candidaturas já chegam por e-mailUma página de candidatura white-label com o nome da sua empresa. Linke a partir do seu site de carreiras ou incorpore em um iframe. O candidato se candidata e é avaliado em um fluxo só.
Ideal para: páginas de carreiras sem um ATS por trásCole uma lista de nomes e e-mails, escolha a vaga e cada candidato recebe um link único. Exporte os resultados pontuados de volta em CSV.
Ideal para: campanhas pontuais e pilotosCrie candidatos a partir do seu ATS no momento em que a candidatura chega, consulte as notas e grave a nota composta de volta no seu próprio registro. JSON entra, JSON sai, autenticação por bearer token.
Ideal para: fornecedores de ATS, RPOs e quem tem sistema de contratação próprioDevoluções e reclamações de spam são reportadas de volta automaticamente, então um convite para um endereço digitado errado aparece como problema em vez de silêncio.
Incluído em todos os métodosUma chave de sandbox cria registros de candidato reais que nunca são cobrados — e permite simular uma avaliação concluída, para você testar sua lógica de pontuação sem fazer um teste de 30 minutos.
Grátis e ilimitadoO que a integração realmente entrega.
Se você conduz a contratação
- A avaliação começa no segundo em que a candidatura chega, não quando alguém tem tempo
- As notas ficam ao lado dos seus próprios registros de candidato — sem um segundo sistema para consultar
- Seu ATS pode ordenar, filtrar e recusar por capacidade verificada, e não por match de palavras-chave
- Nenhum copiar-e-colar para esquecer em um dia corrido
Se você desenvolve software de contratação
- Adicione uma camada de avaliação de verdade sem construir psicometria nem contratar um psicólogo I/O
- 20 perfis de cargo pesquisados, pontuação, verificações de validade e guias de entrevista, prontos para usar
- White-label: seus usuários nunca veem a nossa marca
- Preço por avaliação que você pode revender, a partir de $0.75 em volume
A API em seis endpoints.
URL base https://hirovia.com/api/v1. Autentique com um bearer token obtido em Configurações → API. Chaves que começam com hv_test_ são de sandbox; as hv_live_ são reais e contam no seu plano. 120 requisições por minuto por chave.
| Endpoint | O que faz |
|---|---|
GET /ping | Confirma que a chave funciona e informa em qual modo você está |
GET /roles | Os 20 ids de vaga para os quais você pode avaliar |
POST /candidates | Cria um candidato e devolve o link de avaliação único dele |
GET /candidates | Lista os candidatos, com filtro por status e por vaga |
GET /candidates/{id} | Um candidato com as notas; acrescente ?include=report para o relatório completo |
POST /candidates/{id}/simulate | Somente sandbox. Simula uma avaliação concluída para você testar o tratamento dos resultados |
Criar um candidato
curl -X POST https://hirovia.com/api/v1/candidates \
-H "Authorization: Bearer hv_test_..." \
-H "Content-Type: application/json" \
-d '{
"name": "Jane Doe",
"email": "jane@example.com",
"role": "cam",
"send_email": true
}'
{
"id": 412,
"name": "Jane Doe",
"role": "cam",
"role_title": "Corporate Accounts Manager",
"status": "invited",
"test": true,
"assessment_url": "https://hirovia.com/a/xJ2f8Kq1",
"invitation_emailed": false
}
Envie o candidato para assessment_url você mesmo, ou defina send_email e a Hirovia manda o e-mail em nome da sua empresa.
Ler o resultado
curl https://hirovia.com/api/v1/candidates/412 \ -H "Authorization: Bearer hv_test_..."
{
"id": 412,
"status": "completed",
"completed_at": "2026-08-19T10:41:00Z",
"scores": {
"composite": 89,
"role_fit": 90,
"band": "Exceptional",
"scenarios_pct": 78,
"validity_flags": []
}
}
composite é a nota de ranking de 0 a 100. band é a leitura em linguagem simples da aderência à vaga. Um validity_flags não vazio significa que as respostas pareceram descuidadas ou manipuladas — trate esse perfil com desconfiança, qualquer que seja a nota.
Teste o ciclo inteiro sem um candidato real
curl -X POST https://hirovia.com/api/v1/candidates/412/simulate \
-H "Authorization: Bearer hv_test_..." \
-H "Content-Type: application/json" \
-d '{"band": "weak"}'
Devolve um candidato concluído e completo, com a estrutura do relatório, para você construir e testar o tratamento dos resultados em minutos. Passe "band": "weak" para receber um perfil sinalizado e de nota baixa e testar também o caminho ruim.
Erros
Toda falha devolve o mesmo formato, com um status HTTP que significa exatamente o que diz.
{ "error": { "message": "unknown role 'manager' - call GET /api/v1/roles for valid ids",
"status": 400 } }
| Status | Significado |
|---|---|
| 400 | Algo na sua requisição está errado; a mensagem diz o quê |
| 401 | Chave ausente, inválida ou revogada |
| 402 | Teste grátis esgotado — adicione uma forma de pagamento |
| 403 | Endpoint exclusivo de sandbox chamado com uma chave live |
| 404 | Não existe esse candidato na sua conta |
| 429 | Mais de 120 requisições em um minuto |
Candidatos criados pela API são cobrados como qualquer outro.
O que conta
- Só avaliações concluídas. Criar um candidato pela API é grátis, igual a qualquer convite
- Candidatos criados com chave live contam no volume incluso do seu plano e consomem seu crédito pré-pago
- As tarifas por volume se aplicam automaticamente — até $0.75 por avaliação em escala
- Seus cinco primeiros candidatos são grátis, tenham sido criados como forem
O que nunca conta
- Candidatos de sandbox nunca são cobrados e nunca consomem o seu teste grátis
- Conclusões simuladas são grátis e ilimitadas
- Convites que ninguém responde não custam nada, nunca
- Convites devolvidos ou não entregues não custam nada
Ou seja: você constrói e testa a integração inteira a custo zero e depois troca uma chave para entrar em produção.
Tenha certeza de que quem fez o teste é quem você vai entrevistar.
A IA pode escrever o currículo. Um amigo pode fazer a avaliação. Com a verificação de identidade ativada, cada candidato fotografa um documento oficial e tira uma selfie ao vivo antes da primeira pergunta — assim a pontuação fica vinculada a uma pessoa real e verificada, e o nome do documento é conferido com o nome da candidatura.
A checagem acontece logo no início, então ninguém responde primeiro e verifica depois. Sem documento verificado, não há avaliação.
O Stripe Identity lê o documento, checa os elementos de segurança, confirma que a selfie é de uma pessoa real e a compara com a foto do documento. Funciona com passaportes, carteiras de motorista e documentos nacionais de mais de 100 países.
O relatório mostra verificado / não verificado e se o nome do documento confere com a candidatura. A Hirovia nunca armazena imagens de documentos, números ou datas de nascimento — nada sensível entra na sua conta.
Cobrado uma vez por candidato na primeira tentativa de verificação, qualquer que seja o resultado; quem falhar tem uma nova tentativa sem custo extra. Candidatos nunca pagam. A verificação é um sinal antifraude para o seu processo, não uma checagem de antecedentes nem um relatório de crédito.
Pegue uma chave de sandbox e teste agora.
Grátis, ilimitada, e nada é cobrado até você trocar por uma chave live.