Neste artigo você encontra informações sobre a integração API.
Nosso endereço Swagger possui uma documentação completa e detalhada para que você possa implementar sua integração com as APIs disponibilizadas pela Selsyn. Se você é desenvolvedor de software, com essa documentação você consegue facilmente implementar uma integração, de qualquer maneira, estamos sempre disponíveis para lhe ajudar nesse processo.
Abaixo você encontra um passo a passo de como integrar as APIs utilizando o Postman, que é uma ferramenta bastante conhecida por oferecer suporte a documentação de requisições feitas por APIs.
Primeiro passo você deve ir no:
Swagger (https://editor.swagger.io/?url=https://api.appselsyn.com.br/keek/rest/swagger.json)
Abrindo o Swagger você deve ir na opção 'File'.
Após abrir a aba 'File' você deve clicar em 'Save as JSON' para baixar o arquivo contendo nossas APIs.
Ao baixar este arquivo você deve executar o PostMan em sua máquina. Em seguida, clique nos três risquinhos no canto superior esquerdo e vá na aba File > > Import.
Na sequência, você deve selecionar o arquivo que exportou no Swagger (primeiro passo). Ao selecionar e abrir o arquivo, será direcionado para uma tela com duas opções, onde deve escolher a segunda opção 'OpenAPI 2.0 with a Postman Collection' e clicar no campo de Import.
Após isso você deve abrir sua API na aba de APIs.
Depois disso, você deve clicar na API da Selsyn e irá abrir todos os "End-points" disponíveis.
No próximo passo, você deve configurar sua URL de busca para realizar as requisições dentro do sistema da Selsyn.
Você deve ir na aba Enviroments.
Ir no botão (+) Create new enviroments.
Em Variable você irá adicionar a variável baseUrl.
No campo "initial value" você irá adicionar o link de nossa api como descrito abaixo
"https://api.appselsyn.com.br/keek/rest".
Logo após você deve clicar em Save.
Em seguida você deve ativar este ambiente no botão informado abaixo.
O próximo passo será necessário você gerar um Access token para requisitar os dados do seu cliente.
Você deve ir na aba de API novamente.
Após isso você deve abrir a aba de login.
Será necessário você solicitar ao suporte Selsyn (48)99134-3369) a sua APIKEY de integrador para realizar as buscas/cadastros.
Após ter a sua API-KEY de integrador em mãos você deve abrir esta a aba Headers e informar a API-KEY.
Agora você irá informar o usuário e senha do seu cliente para assim gerar o accessToken.
Após ter o accessToken você irá em Environments e criar a variável 'apiKey' e adicionar o accessToken do seu cliente no campo 'Initial value'.
Seguindo esses passos você está apto a realizar todas as requisições das APIs disponíveis na documentação.