Para habilitar o uso da API, precisamos criar uma nova chave de integracão na plataforma. Essa chave serve para fazermos a autenticacão na API e pode ser criada usando três modos diferentes “leitura”, “escrita” ou “ambos”.

Para criar uma nova integracão, faça o seguinte:

1. No menu superior clique em Integracões.

2. Clique no botão Nova Integracão.

3. Selecione a organizacão para qual a integração será criada.

4. Selecione o escopo que será utilizado na integracão (se apenas leitura, apenas escrita ou ambos).

5. Digite um nome para identificar para essa integracão posteriormente.

6. Clicar em Salvar.

7. Você será redirecionado para uma tela com informacões importantes sobre a integracão como

   ID da Organização

   Chave de Integração

Com o ID da Organização e a Chave de Integração iremos comecar o processo de integracão com a API.

Para autenticar na API, faça o seguinte:

1. No menu superior clique em Integracões.
2. Clique no botão Documentacão da API.

3. Clique no endpoint chamado Session e depois clique no botão Try it out
4. Digite o ID da Organizacão a Chave de Integracão
5. Clique no botão Execute.

   Você recebera um Access Token na resposta, copie esse token para que possamos utilizar no próximo passo.

6. Na mesma tela do Swagger UI clique no botão Authorize.

7. Cole o Access Token no campo e depois clique no botão Authorize.

Agora você está logado na API e poderá utiliza-lá.