Exchange - GrupoBRA/GovAPI-Doc GitHub Wiki

Exchange

POST /v1/exchange/

Retorna um exchange com os cargos e lotações passados no payload

  1. Checar se existe na tabela "cargo" os documentos contendo as chaves "oid", "oeid" e "cargo_id" que estão no token do usuário e no payload, respectivamente e com status ativo;

  2. Checar se existe na tabela "lotacao" os documentos contendo as chaves "oid", "oeid" e "lotacao" que estão no token do usuário e no payload, respectivamente e com status ativo;

  3. Caso os itens 1 e 2 não retornem dados, retornar status code 404;_

  4. Retornar os dados obtidos nos itens 1 e 2;

Header:

Authorizarion: Bearer {JWT}

Validação do body:

  • Todos os campos devem ser informados;
  • Pelo menos um dos campos devem ser informados;
  • Informar "null" quando não for informado informação para algum campo

Caso alguma dessas condições não sejam satisfeitas, retornar status code 406;

Body:

{
  "cargo_ids": [
    "{cargo_id1}",
    "{cargo_id2}",
    "{cagor_id3}"
  ],
  "lotacao_ids": [
    "{lotacao_id1}",
    "{lotacao_id2}",
    "{lotacao_id3}"
  ]
}

Resposta:

{
  "success": true,
  "data": {
    "GovernancaAPI": { 
      "cargos": [
        {
          "cargo_id":"{id}",
          "cargo":"Título do cargo",
          "cbo": "CBO"
        }
      ],
      "lotacoes": [
        {
          "lotacao_id":"{id}",
          "lotacao":"Título da lotação"
        }
      ]
    }
  }
}

Resposta:

200 | 403 | 404 | 406