Get position

Exibe a posição selecionada.

GET Url Produção: https://api.acessorh.com.br Url Homologação: https://api.rh.homolog.acesso.io Endpoint:/v1/positions/:position

Headers

Key
Type
Description

Authorization*

string

Token de acesso adquirido pela plataforma Identity (bearer)

Path Parameters

Key
Type
Description

position*

string

UID ou código da posição desejada (obrigatório). Consulte aqui.

Query Parameters

Key
Type
Description

unit

string

UID da filial do qual a posição pertence. Consulte aqui.

includes

string

Lista com os campos opcionais que podem ser visualizados separados por vírgula

Campos opcionais | includes

"role","benefits","department","persons","unit","attachments","decline"

Exemplo de requisição

curl --location 'https://api.acessorh.com.br/v1/positions/UID DO CANDIDATO?includes=role%2Cbenefits%2Cdepartment%2Cpersons%2Cunit%2Cattachments%2Cdecline' \
--header 'Authorization: Bearer token de autorização' \
--data ''

Exemplos de response

O retorno de todos metadados dos documentos e os paths dos arquivos anexados pelos candidatos é enviado na resposta do parâmetro "includes > persons" dentro de cada person do cadastro. Cada "kind" de documento tem uma estrutura diferente para o retorno dos metadados hardcoded (Padrão): Para a maioria dos documentos, como RG e CPF, as informações preenchidas pelo candidato são exibidas diretamente no campo data em um formato de chave-valor.

dictionary_specification (Dicionário): Documentos como os certificados (CPA-20, CEA, CGA) têm uma estrutura diferente. O campo data contém uma estrutura completa do documento, e os valores preenchidos pelo candidato estão aninhados no sub-objeto validator.

dynamic-document (Dinâmico): Este tipo, como o comprovante de Graduação, também armazena os dados no campo data, mas com uma estrutura que inclui um dicionário de valores (values) e uma lista de comprovantes.

Para consultar o "kind" de cada documento, você pode usar essa api.

Exemplo de resposta com todos os campos opcionais solicitados.

200 OK - Expandir para mais detalhes

Outros exemplos - dicionários

Deficiência/candidatos PCD - expandir aqui
Graduação - expandir aqui
Instituição - expandir aqui
Identidade de Genero - expandir aqui
Orientação sexual - expandir aqui
Etnia - expandir aqui
Estado civil - expandir aqui
Tipo nacionalidade - expandir aqui
Escolaridade - expandir aqui
Dependente - expandir aqui
Tipo de logradouro - expandir aqui
Tipo de municipio - expandir aqui
Slugs e types de documentos - expandir aqui

Para consultar os slugs e types de documentos agora temos uma nova API - consulte aqui.


Atualizado

Isto foi útil?