Cargos - GrupoBRA/GovAPI-Doc GitHub Wiki
Obtendo os cargos
GET /v1/cargo/
Retorno:
{
"success":true,
"data":{
"GovernancaAPI":[
{
"cargo_id":"{id}",
"cargo":"Título do cargo",
"cbo": "CBO"
"uupfid": "{snowflake_id}",
"data_hora": "{%Y-%m-%d %H:%M-%S}"
}
]
}
}
Obtendo um cargo
GET /v1/cargo/{cargo_id}/
Retorno:
{
"success":true,
"data":{
"GovernancaAPI":{
"cargo_id":"{id}",
"cargo":"Título do cargo",
"cbo": "CBO",
"uupfid": "{snowflake_id}",
"data_hora": "{%Y-%m-%d %H:%M-%S}"
}
}
}
Obtendo cargos vinculados a uma lotação
GET
Endpoint: /v1/cargo/lotacao/{lotacao_id}/
Retorno:
{
"success":true,
"data":{
"GovernancaAPI":[
{
"cargo_id":"{id}",
"cargo":"Título do cargo",
"cbo": "CBO",
"uupfid": "{snowflake_id}",
"data_hora": "{%Y-%m-%d %H:%M-%S}"
}
]
}
}
Pesquisando os cargos por semelhança
GET /v1/cargo/search/{needle}/
Retorno:
{
"success":true,
"data":{
"GovernancaAPI":[
{
"cargo_id":"{id}",
"cargo":"Título do cargo",
"cbo": "CBO",
"uupfid": "{snowflake_id}",
"data_hora": "{%Y-%m-%d %H:%M-%S}"
}
]
}
}
Inserindo um cargo
POST /v1/cargo/
Insere um novo cargo para o oid do usuário logado
Payload:
{
"cargo": "(nome_lotação)",
"cbo": "(opcional)"
}
Retorno:
{
"success":true,
"data":{
"GovernancaAPI":
{
"cargo_id":"{id}"
}
}
}
201 | 403 | 406 | 409
Alterando um cargo
PUT /v1/cargo/{cargo_id}/
Altera os dados de um cargo pela sua id
Payload:
{
"cargo": "(nome_cargo)",
"cbo": "(opcional)"
}
200 | 403 | 406 | 409
Removendo um cargo
DEL /v1/cargo/{cargo_id}/
Desativa a exibição de um cargo pela sua id
204 | 403 | 406 | 409