README ConnectTEF | Índice da Seção | Anterior | Próximo —
Caminho: Início / Integrações / Integracao via API Local
A API Local permite que aplicações Desktop ou sistemas executados na mesma rede se comuniquem diretamente com o ConnectTEF instalado no computador ou servidor local.
Diferentemente da API REST em nuvem, essa comunicação ocorre inteiramente dentro da infraestrutura do cliente, eliminando a necessidade de acesso à Internet durante a troca de mensagens entre o ERP e o ConnectTEF.
Essa arquitetura oferece maior desempenho, menor latência e mantém a operação disponível mesmo em ambientes sem conexão com a Internet.
Apresentar o funcionamento da API Local, seus benefícios e os cenários em que ela representa a melhor alternativa de integração.
O ERP comunica-se diretamente com o serviço do ConnectTEF instalado na máquina ou na rede local.
Toda a comunicação ocorre utilizando protocolos HTTP através da rede interna.
ERP / PDV
│
│ HTTP (Rede Local)
▼
ConnectTEF Local
│
├── SmartPOS
├── Adquirentes
└── Serviços da Plataforma
A Internet somente será utilizada quando necessária para comunicação com serviços externos, como adquirentes ou recursos hospedados em nuvem.
A API Local é indicada para:
A comunicação entre ERP e ConnectTEF permanece disponível mesmo durante falhas na conexão externa.
Isso garante continuidade operacional e reduz interrupções causadas por problemas de conectividade.
Como toda a comunicação ocorre dentro da rede local, o tempo de resposta é significativamente menor quando comparado às integrações que dependem da Internet.
A integração utiliza chamadas HTTP tradicionais.
Não há necessidade de DLLs específicas ou protocolos proprietários para comunicação com a aplicação comercial.
O ERP permanece independente dos fabricantes de SmartPOS e dos protocolos utilizados por cada equipamento.
Toda essa complexidade permanece encapsulada no ConnectTEF.
Por utilizar HTTP, praticamente qualquer tecnologia pode integrar-se utilizando a API Local.
Exemplos:
A API Local disponibiliza acesso aos mesmos serviços oferecidos pela plataforma, incluindo:
A disponibilidade de recursos depende da versão instalada do ConnectTEF.
Embora a comunicação ocorra dentro da rede local, continuam sendo aplicados mecanismos de segurança, como:
A API Local deve ser utilizada quando:
| API REST | API Local |
|---|---|
| Comunicação via Internet | Comunicação pela rede local |
| Ideal para aplicações Web e SaaS | Ideal para aplicações Desktop |
| Pode operar remotamente | Opera dentro da infraestrutura local |
| Integração desacoplada | Integração desacoplada |
| HTTP/HTTPS | HTTP Local |
Ambas utilizam os mesmos conceitos arquiteturais, diferenciando-se apenas pelo ambiente onde ocorre a comunicação.
Nos próximos capítulos serão apresentados outros modelos de integração, incluindo bibliotecas nativas para Windows, SDK Android e mecanismos de compatibilidade com aplicações legadas.