O ProjectCanvas permite a integração via API Rest, para que as informações possam ser consultadas de modo automatizado em outras ferramentas, trazendo ainda mais possibilidades.

Para essa integração acontecer o usuário "Administrador" deve criar um novo usuário para este fim.

No canto superior direito vá em "Menu" e acesse "Gestão de usuarios" , vá ao botão "+"  (Novo Usuário) e preencha o formulário marcando a opção "Integrador API", depois clique em "CONFIRMAR"

Feito isso, podemos acessar o link da documentação da API para realizar a integrações:

https://app.projectcanvas.online/api-docs

A documentação é baseada na ferramenta Swagger, onde é exibido as API's que estão disponíveis e fornece a possibilidade de testar as API's diretamente nesta página.

A primeira coisa é selecionar qual o ambiente faremos nosso teste de integração, no combo de seleção chamado "Servers":

Depois é necessário chamar a API "/api/v1/users/authenticate" e realizar o login com os dados de e-mail e senha do usuário "integrador" que acabamos de criar, clicando no botão "Execute". 

Após chamar a API de Autenticação receberemos um token.

Este token deve ser fornecido clicando no botão "Authorize", dessa forma o token será informado no header de cada requisição feita para consumo das informações.

Realizando os passos acima será possível ter uma base de entendimento de como as API's funcionam e assim realizar a criação de scripts em linguagens de programação que integrem com as API's.

Pontos de atenção:

- Um usuário do tipo integrador só realiza login via API;

- Este recurso é somente para clientes do plano Corporativo;