Endpoint para publicar vaga no sistema do Vagas for Business
Os atributos cargo, descrição do anuncio e outros requisitos do anúncio aceitam algumas tags HTML para formatação do texto, as opções permitidas estão listadas abaixo.
Tags HTML permitidas:
- span
- br
- p
- ul
- ol
- li
- b
- i
- u
- strong
- em
- div
- h1
- h2
- h3
- h4
- h5
- h6
Body
Required
-
IDs das fases que a vaga terá, os ids podem ser obtidos no endpoint
/v1/job-posting/phases -
ID da vaga modelo que pode ser usada como base para criação da vaga, caso a vaga modelo tenha algum atributo que também foi passado na criaçao da vaga, o atributo da vaga modelo será ignorado e será usado o atributo passado na requisição o id pode ser obtido no endpoint
/v1/job-posting/job_models -
Lista de emails para notificar quando a vaga for publicada
-
Titulo da vaga
-
Id do tipo de contratação. Pode ser obtido no endpoint
/v1/dominios/modelos-contratuais -
Número de posições abertas para a vaga
-
Idiomas necessários para a vaga, as opções podem ser obtidas no endpoint
/v1/dominios/idiomas -
Beneficios oferecidos. Os ids podem ser obtidos no endpoint
v1/job-posting/benefits. Um beneficio não pode ser fornecido duas vezes -
Se o valor for true, a vaga será publicada como vaga inteligente
curl \
--request POST 'https://apigateway.vagas.com.br/v1/job-posting/jobs' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"fases_ids": [
999,
999
],
"vaga_modelo_id": 999,
"notificar": [
"contato@empresa.com",
"rh@email.com"
],
"cargo": "Engenheiro",
"cargo_exclusivo_pcd": false,
"tipo_de_contratacao_id": 999,
"numero_de_posicoes": 1,
"idiomas": [
{
"id": 534,
"nivel_id": 5
}
],
"beneficios": [
{
"id": 2,
"valor": 80
}
],
"anuncio": {
"descricao": "Descrição da vaga",
"outros_requisitos": "Ter certificação em Inglês"
},
"salario": {
"tipo_moeda": "BRL",
"faixa_salario_min": 999,
"faixa_salario_max": 999,
"exibir_salario_no_anuncio": true
},
"pre_requisitos": {
"escolaridade_minima_id": 1,
"nivel_hierarquico_id": 3,
"aceitar_candidaturas_outras_areas": true,
"areas_de_atuacao_ids": [
4,
6,
10
]
},
"atuacao": {
"modelo_de_trabalho": 4,
"local_aceita_candidaturas": "cidades_proximas",
"local_de_trabalho": {
"pais_id": 999,
"estado_id": 999,
"cidade_id": 999
}
},
"sobre_a_empresa": {
"anuncio_confidencial": false,
"apresentacao_da_empresa": 999
},
"periodo_de_inscricao": {
"data_inicio": "2024/01/01",
"data_fim": "2024/01/31",
"veiculacao_suspensa": false
},
"acesso_restrito": {
"vaga_restrita": false,
"senha": "S3nh@"
},
"canais_de_divulgacao": {
"divisao_id": 999,
"parceiros_ids": [
999
]
},
"vaga_inteligente": false
}'
{
"fases_ids": [
999,
999
],
"vaga_modelo_id": 999,
"notificar": [
"contato@empresa.com",
"rh@email.com"
],
"cargo": "Engenheiro",
"cargo_exclusivo_pcd": false,
"tipo_de_contratacao_id": 999,
"numero_de_posicoes": 1,
"idiomas": [
{
"id": 534,
"nivel_id": 5
}
],
"beneficios": [
{
"id": 2,
"valor": 80
}
],
"anuncio": {
"descricao": "Descrição da vaga",
"outros_requisitos": "Ter certificação em Inglês"
},
"salario": {
"tipo_moeda": "BRL",
"faixa_salario_min": 999,
"faixa_salario_max": 999,
"exibir_salario_no_anuncio": true
},
"pre_requisitos": {
"escolaridade_minima_id": 1,
"nivel_hierarquico_id": 3,
"aceitar_candidaturas_outras_areas": true,
"areas_de_atuacao_ids": [
4,
6,
10
]
},
"atuacao": {
"modelo_de_trabalho": 4,
"local_aceita_candidaturas": "cidades_proximas",
"local_de_trabalho": {
"pais_id": 999,
"estado_id": 999,
"cidade_id": 999
}
},
"sobre_a_empresa": {
"anuncio_confidencial": false,
"apresentacao_da_empresa": 999
},
"periodo_de_inscricao": {
"data_inicio": "2024/01/01",
"data_fim": "2024/01/31",
"veiculacao_suspensa": false
},
"acesso_restrito": {
"vaga_restrita": false,
"senha": "S3nh@"
},
"canais_de_divulgacao": {
"divisao_id": 999,
"parceiros_ids": [
999
]
},
"vaga_inteligente": false
}
{
"id": 2505124,
"cargo_exclusivo_pcd": false,
"cargo": "Analista de crédito",
"numero_de_posicoes": 2,
"tipo_de_contratacao_id": 4,
"funcionario_id": 17742,
"empresa_id": 12702,
"data_criacao": "2023-05-03T11:13:34-03:00",
"fases_ids": [
469731,
649710,
641396
],
"canais_de_divulgacao": {
"divisao_id": 67518,
"parceiros_ids": [
11,
10
]
},
"acesso_restrito": {
"vaga_restrita": true
},
"sobre_a_empresa": {
"anuncio_confidencial": false,
"apresentacao_da_empresa": 139
},
"anuncio": {
"descricao": "Descrição da Vaga",
"outros_requisitos": "sem comentários"
},
"periodo_de_inscricao": {
"data_inicio": "2023-05-03",
"data_fim": "2023-05-03T21:00:00-03:00",
"veiculacao_suspensa": false
},
"salario": {
"tipo_moeda": "BRL",
"faixa_salario_min": 1500,
"faixa_salario_max": 2000,
"exibir_salario_no_anuncio": true
},
"idiomas": [
{
"id": 20,
"nivel_id": 2
}
],
"pre_requisitos": {
"escolaridade_minima_id": 60,
"nivel_hierarquico_id": 40,
"areas_de_atuacao_ids": [
70,
1,
124
]
},
"atuacao": {
"modelo_de_trabalho": 2,
"local_aceita_candidaturas": "somente_cidade",
"local_de_trabalho": {
"localizacao_completa": "Angra dos Reis, RJ, Brasil",
"pais": "Brasil",
"estado": "RJ",
"cidade": "Angra dos Reis",
"cidade_id": 60968
}
},
"fichas_gerenciais": [
{
"id": 23
}
],
"beneficios": [
{
"id": 2,
"valor": 34.5
}
],
"fichas": [
{
"id": 147637,
"obrigratoria": true
}
],
"vaga_inteligente": false
}