Neste guia você vai aprender como consumir APIs no Fluig utilizando REST e SOAP. Esse tipo de integração é essencial para conectar o Fluig com outros sistemas e automatizar processos.
1. O que são APIs no contexto do Fluig?
APIs permitem que o Fluig se comunique com sistemas externos, enviando e recebendo dados. Essa comunicação é fundamental para integrações com ERPs, CRMs e outros serviços.
2. REST vs SOAP: quando usar?
- REST: mais leve, usa JSON e é o mais comum hoje, exemplo Protheus
- SOAP: mais estruturado, usa XML e é comum em sistemas legados, exemplo RM
3. Como o Fluig consome APIs?
No Fluig, integrações são feitas geralmente utilizando o ClientService, disponível em datasets e eventos.
4. Exemplo de consumo REST
var clientService = fluigAPI.getAuthorizeClientService();
var data = {
companyId: getValue("WKCompany"),
serviceCode: "nome_do_servico",
endpoint: "/api/exemplo",
method: "get",
timeoutService: "100"
};
var response = clientService.invoke(JSON.stringify(data));
5. Exemplo de consumo SOAP
var clientService = fluigAPI.getAuthorizeClientService();
var data = {
companyId: getValue("WKCompany"),
serviceCode: "servico_soap",
endpoint: "",
method: "post",
params: "... "
};
var response = clientService.invoke(JSON.stringify(data));
6. Erros comuns
- Configurar errado o serviço no Fluig
- Problemas de autenticação
- Timeout de requisição
- Erro no formato JSON/XML
7. Boas práticas
- Centralizar integrações em datasets
- Tratar erros com try/catch
- Logar respostas para debug
- Evitar chamadas desnecessárias
Conclusão
Saber consumir APIs no Fluig é essencial para criar soluções integradas e escaláveis. Dominar REST e SOAP permite trabalhar com qualquer tipo de sistema externo.