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

circle-info

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.

chevron-right200 OK - Expandir para mais detalheshashtag

Outros exemplos - dicionários

chevron-rightDeficiência/candidatos PCD - expandir aquihashtag
chevron-rightGraduação - expandir aquihashtag
chevron-rightInstituição - expandir aquihashtag
chevron-rightIdentidade de Genero - expandir aquihashtag
chevron-rightOrientação sexual - expandir aquihashtag
chevron-rightEtnia - expandir aquihashtag
chevron-rightEstado civil - expandir aquihashtag
chevron-rightTipo nacionalidade - expandir aquihashtag
chevron-rightEscolaridade - expandir aquihashtag
chevron-rightDependente - expandir aquihashtag
chevron-rightTipo de logradouro - expandir aquihashtag
chevron-rightTipo de municipio - expandir aquihashtag
chevron-rightSlugs e types de documentos - expandir aquihashtag

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

file-download
458KB

Atualizado

Isto foi útil?