Integração e API
SOAP
Equivale a um envelope formal para chamadas entre sistemas: SOAP empacota cabeçalho e corpo em XML e costuma usar HTTP, embora não dependa dele. Contratos WSDL descrevem operações e tipos; extensões WS-* cobrem segurança, endereçamento e confiabilidade. Comparado a REST/JSON, produz mensagens maiores e implementação mais pesada, mas oferece contratos rígidos úteis em sistemas corporativos e prediais legados. Integrações residenciais modernas raramente o escolhem para novos projetos.
🔀 Tipos de Comunicação
XML
Envelope XML
Toda mensagem possui Envelope, Header opcional e Body com a operação ou resposta serializada em XML.
WSDL
Contrato WSDL
O documento descreve operações, tipos, bindings e endereços, permitindo geração de clientes fortemente tipados.
WS-*
WS-Security
Assinatura, criptografia e tokens podem ser aplicados no nível da mensagem, além do transporte TLS.
Fault
Fault estruturado
Erros seguem um formato próprio com código, motivo e detalhes de processamento.
✅ Vantagens Arquiteturais
⚡
Contrato formal
WSDL e XML Schema reduzem ambiguidades em integrações corporativas de longa duração.
⚡
Extensões maduras
Padrões WS-* cobrem segurança, confiabilidade, endereçamento e transações.
⚡
Geração automática
Ferramentas criam proxies e classes a partir do contrato publicado.
⚡
Interoperabilidade legada
Permite integrar BMS, ERPs, serviços governamentais e plataformas empresariais existentes.