Documentação da API JuntoAqui

Utilize nossa API para integrar a publicação de vagas no JuntoAqui diretamente pelos seus sistemas de RH, automatizando seu processo de recrutamento.

Como obter sua Chave de API

Sua chave de API única é gerada automaticamente para empresas cadastradas e pode ser encontrada no painel de controle da sua empresa.

Autenticação

Todas as requisições para a API devem incluir sua chave no cabeçalho (header) da requisição:

X-API-Key: SUA_CHAVE_API_AQUI
Substitua pelo token real do seu painel administrativo
Importante: Use exclusivamente a chave da sua empresa, disponível no painel de controle. Não compartilhe este token com terceiros.

Endpoints

GET

/api/v1/jobs

Retorna uma lista paginada das vagas ativas da sua empresa.

Parâmetros de Query (Opcionais)
  • page: Número da página (padrão: 1).
  • per_page: Itens por página (padrão: 10).
  • search: Busca por termo no título ou descrição.
  • location: Filtra por localização.
  • type: Filtra por tipo de vaga (ex: full-time, remote).
  • category_id: Filtra por ID da categoria ou cargo.
POST

/api/v1/jobs

Cria uma nova vaga. O corpo da requisição deve ser um JSON.

Corpo da Requisição (JSON)

Campos Obrigatórios: title, description, job_category_id, cut_off_score, technical_tests.

{
    "title": "Engenheiro(a) de Software (Backend)",
    "description": "Buscamos um(a) profissional para desenvolver e manter nossas soluções de backend.",
    "activities": "Desenvolver novas features, manter APIs, colaborar com o time de frontend.",
    "requirements": "3+ anos com Python, experiência com Django/Flask, bancos de dados SQL.",
    "benefits": "Plano de saúde, vale refeição, horário flexível.",
    "location": "São Paulo, SP",
    "job_type": "full-time",
    "salary": "A combinar",
    "required_experience_level": "Pleno",
    "education_level": "Superior Completo",
    "education_field": "Ciência da Computação, Análise de Sistemas",
    "is_confidential": false,
    "selection_duration": 45,
    "cut_off_score": 75,
    "job_category_id": 15,
    "technical_tests": [4, 6],
    "personality_tests": [1, 2]
}
Detalhes dos Campos
  • activities, benefits, requirements: Textos com as respectivas informações.
  • location: Cidade e estado da vaga (ex: "São Paulo, SP").
  • job_type: Tipo de contrato. Valores possíveis: full-time, part-time, contract, internship, remote, hybrid.
  • salary: String com o valor do salário ou "A combinar".
  • required_experience_level: Nível de experiência. Valores possíveis: Estagiário, Júnior, Pleno, Sênior, Especialista / Liderança.
  • education_level: Escolaridade mínima. Valores possíveis: Ensino Médio Completo, Curso Técnico, Superior Incompleto, Superior Completo, Pós-graduação, Mestrado, Doutorado.
  • education_field: String com as áreas de formação desejadas, separadas por vírgula.
  • is_confidential: Booleano (true/false) para indicar se a vaga é confidencial.
  • selection_duration: Número de dias que o processo seletivo ficará ativo (padrão: 30).
  • cut_off_score: (Obrigatório) Número (0-100). Média mínima em porcentagem para aprovação automática nos testes técnicos.
  • job_category_id: (Obrigatório) Número com o ID do cargo da vaga.
  • technical_tests: (Obrigatório) Array com pelo menos um ID de teste técnico a ser aplicado. A lista não pode ser vazia.
  • personality_tests: (Opcional) Array com os IDs dos testes de personalidade a serem aplicados. Envie [] ou omita o campo se nenhum for necessário.
Limite de Testes por Vaga

A quantidade total de testes (técnicos + personalidade) que pode ser associada a uma vaga é determinada pelo seu plano ativo. Requisições que excederem o limite do seu plano serão rejeitadas com o status 403 Forbidden. Consulte os detalhes do seu plano para verificar o limite disponível.

IDs de Categorias de Vaga Disponíveis

Nenhuma categoria de vaga disponível.

IDs de Testes Disponíveis

Nenhum teste técnico disponível.

Nenhum teste de personalidade disponível.