Acesso via API ou via banco de dados?

Razões pelas quais a TOTVS recomenda o uso de APIs em vez do acesso direto ao banco de dados:

• Abstração e Camada de Negócios: As APIs fornecem uma camada de abstração sobre a estrutura do banco de dados. Isso significa que as aplicações que consomem a API não precisam conhecer os detalhes complexos das tabelas, campos e relacionamentos do banco de dados. A lógica de negócios e as regras de acesso aos dados são encapsuladas na API.
• Manutenção e Evolução: Ao utilizar APIs, as alterações na estrutura do banco de dados podem ser feitas de forma mais transparente para as aplicações consumidoras. Se o acesso fosse direto, qualquer modificação no banco poderia quebrar as aplicações existentes. As APIs atuam como um contrato, mantendo a estabilidade da interface mesmo com mudanças internas.
• Segurança: As APIs permitem implementar mecanismos de segurança robustos, como autenticação, autorização e controle de acesso em nível de funcionalidade. Isso garante que apenas usuários e sistemas autorizados possam acessar os dados e funcionalidades específicas, reduzindo o risco de acessos indevidos e manipulação de dados sensíveis.
• Integridade dos Dados: As APIs podem garantir a integridade dos dados através de validações e regras de negócio implementadas em sua lógica. Isso evita que dados inconsistentes ou inválidos sejam gravados no banco de dados, o que poderia ocorrer com um acesso direto sem essas verificações.
• Auditoria e Rastreabilidade: O uso de APIs facilita a auditoria das operações realizadas nos dados. É possível registrar quem acessou quais informações e quando, o que é importante para rastreabilidade e conformidade.
• Performance e Escalabilidade: APIs bem projetadas podem otimizar o acesso aos dados, retornando apenas as informações necessárias e utilizando mecanismos de cache. Isso pode melhorar a performance e a escalabilidade das aplicações.
• Padronização e Interoperabilidade: As APIs seguem padrões de comunicação (como REST) que facilitam a integração com diferentes sistemas e tecnologias, promovendo a interoperabilidade.

Onde encontrar informações relacionadas na documentação da TOTVS:

• Documentação de APIs: A TOTVS possui vasta documentação para suas diversas APIs, detalhando como utilizá-las para acessar dados e funcionalidades de seus sistemas (como Protheus, Datasul, RM, Fluig). Essa documentação implicitamente incentiva o uso dessas interfaces. Você pode encontrar informações sobre as APIs da TOTVS em portais de desenvolvedores (como o api reference - totvs developers) e na documentação específica de cada linha de produto.
• Guias de Integração: Os guias de integração fornecidos pela TOTVS geralmente detalham as formas recomendadas de conectar sistemas externos aos seus produtos, sendo as APIs o método primário https://api.totvs.com.br/get-started
• Melhores Práticas de Desenvolvimento: Em documentos sobre melhores práticas de desenvolvimento com as tecnologias TOTVS, é comum encontrar a recomendação de utilizar as APIs fornecidas para acesso a dados, em vez de manipular diretamente o banco.
• Arquitetura de Soluções: A arquitetura de soluções da TOTVS, apresentada em suas documentações e treinamentos, geralmente enfatiza o papel das APIs como a camada de comunicação padrão entre diferentes componentes e sistemas.