# Hub API - Aprova

O Hub API é uma plataforma de abstração de APIs projetada para padronizar e simplificar a integração de sistemas de parceiros terceiros com o Aprova. O principal objetivo é criar um ponto de entrada único e seguro para as funcionalidades do Aprova. Utilizamos um sistema de autenticação robusto para garantir que o uso dos nossos serviços por terceiros seja seguro, controlado e intuitivo. Isso facilita o trabalho de desenvolvedores externos e reduz a complexidade da integração.

## Como Obter sua Chave API
Para começar a usar o Hub API, siga os passos abaixo para habilitar a funcionalidade e gerar suas chaves de acesso:

**Passo 1: Ative a Permissão de Administrador**
- Navegue até: *Outros > Administração Geral > Permissões > Todas as Permissões*
- Ative a permissão `hubapi:admin`
- Vincule essa permissão a um grupo de usuários administradores
- Saia do sistema e entre novamente

**Passo 2: Acesse o Gerenciador de Chaves**
- Após ativar a permissão, um novo menu aparecerá
- Navegue até: *Outros > Administração Geral > Gerenciar Ambiente > Chaves API - Hub API*

**Passo 3: Crie sua Chave API**
- Clique em **Criar Chave API**
- Defina um nome único para identificar a chave
- Copie e salve a chave exibida imediatamente

**IMPORTANTE:**
A chave API será exibida por completo apenas **uma vez**.
Após sair da tela, por motivos de segurança, a chave completa **não será mostrada novamente**.
Certifique-se de armazená-la em um local seguro.



## Servers

```
https://api.producao.aprova.com.br
```

## Security

### Authorization

Authorization

Type: apiKey
In: header
Name: Authorization

### InternalAuth

Internal Authentication Key

Type: apiKey
In: header
Name: x-api-key

## Download OpenAPI description

[Hub API - Aprova](https://hubapi.aprova.com.br/_bundle/aprovahubapi.yaml)

## Process

Operações relacionadas à consulta de processos

### Consulta um processo por np e codvalid

 - [POST /hub-api/process/get-by-np](https://hubapi.aprova.com.br/aprovahubapi/process/consultprocessv1http.md): Este endpoint permite consultar um processo específico utilizando o número do processo (nP) e o código validador (codValid).

### Cria um processo sem validação de regras de formulário

 - [POST /hub-api/process/create](https://hubapi.aprova.com.br/aprovahubapi/process/createprocessv1http.md): Cria um processo sem validação de regras de formulário (salva a version da forma que recebeu). Este endpoint permite criar processos diretamente sem passar pelas validações padrão do sistema.

## Users

Operações relacionadas à consulta de usuários

### Consulta informações de um usuário

 - [GET /hub-api/users](https://hubapi.aprova.com.br/aprovahubapi/users/getuserv1http.md): Consulta dados detalhados de um usuário a partir do identificador do Aut0.