Conectores
O que São Conectores?
Conectores são componentes responsáveis por fazer a comunicação entre a plataforma e sistemas externos (APIs, serviços ou aplicações). Eles funcionam como uma camada de integração, padronizando chamadas, autenticação e troca de dados entre diferentes sistemas.
Para que servem os conectores?
Com conectores, você consegue:
-
Integrar sistemas externos (ex: SAP, VTEX, HubSpot, APIs internas)
-
Centralizar regras de comunicação e autenticação
-
Reutilizar chamadas em vários fluxos
-
Evitar código duplicado
-
Facilitar manutenção e evolução da integração
Hoje a DevAPI oferece uma variedade de conectores, e você pode utiliza-los de acordo com os seus objetivos:
Verifique que existem 2 opções, sendo elas:
1️⃣ Conectores Privados São conectores que você clonou a partir de um conector da própria plataforma e customizou conforme a sua necessidade, adaptando regras, rotas ou comportamentos específicos.
2️⃣ Conectores Pre-Built São conectores fornecidos pela própria plataforma, já prontos para uso, seguindo um padrão definido e pensados para atender aos cenários mais comuns de integração.
🧠 Para facilitar as Buscas você também pode utilizar os recursos de filtro para encontrar um conector com base na categoria de pesquisa
Iniciando um Conector Novo
Primeiramente clique em Novo Conector, iremos iniciar um de três formas. Note que terá 2 opções, criar um do zero colocando de forma manual todas as rotas ou criar um a partir de uma rota swegger
Criando um Conector via Swegger
Para funcionar, você deve passar uma URL válida de um documento Swegger, e que esteja bem documentado com todas as rotas htps de uso
Após ter clicado em exportar, ele irá salvar as informações e me levará ao inicio da páginas de conectores, cliquei no conector novo criado, note que ele importou todas as informações das rotas do meu swegger no meu conector novo:
Criando um Conector do Zero
De forma manual, será necessário preencher todos os campos
Para criar novas rotas que serão utilizadas nas chamadas, clique no método HTTP correspondente à rota desejada. Caso a URL possua versionamento, ajuste inicialmente a versão e, em seguida, vá complementando o caminho conforme a estrutura da rota que será utilizada.
A partir disso, você poderá estruturar cada rota individualmente, configurando as chamadas de acordo com cada rota específica
estando tudo certo, basta salvar e já terá um conector disponivel.
Criando um Conector a Partir de uma Clonagem.
Basta clicar no Conector da sua preferencia, é importante que seja um conector caracterizado como Pre-Built.
Coloque o nome que irá se chamar o seu conector modificado com novas alterações
Clique em Salvar
Perfeito! Agora você pode personalizar o conector de acordo com as suas necessidades, adicionando novas rotas, ajustando as existentes ou removendo aquelas que não façam mais sentido para o seu cenário. A continuação do processo segue exatamente os mesmos passos explicados na criação de um conector do zero. A principal diferença é que, ao clonar um conector já existente, você já contará com grande parte das configurações previamente prontas, o que agiliza significativamente o desenvolvimento.
