Embora os endpoints da API da Sunra possam ser acessados diretamente do código do lado do cliente, armazenar chaves de API em tais ambientes representa riscos de segurança significativos. Para resolver isso, os desenvolvedores normalmente criam APIs personalizadas do lado do servidor que interagem com segurança com serviços de terceiros como a Sunra antes de retornar os resultados ao cliente. Embora eficaz, essa abordagem muitas vezes distrai as equipes de se concentrarem em seus principais objetivos de negócios. Para simplificar esse processo, desenvolvemos bibliotecas de cliente que suportam um modo de proxy. Esse recurso permite que você utilize as bibliotecas de cliente em seu código de frontend, mantendo as chaves de API seguras em sua infraestrutura do lado do servidor.

​
Soluções de Proxy Pré-construídas

Oferecemos soluções de proxy pré-construídas para várias estruturas populares:
  • Node.js com Next.js: um manipulador de rota de API do Next.js que pode ser usado em qualquer aplicativo Next.js. Ele suporta os roteadores Page e App. Nós mesmos o usamos em todos os nossos aplicativos em produção.
  • Node.js com Express: um manipulador de rota do Express que pode ser usado em qualquer aplicativo Express. Você também pode implementar lógica personalizada e compor junto com seus próprios manipuladores.
Estamos comprometidos em expandir nossas ofertas com base no feedback da comunidade. Se você tiver solicitações ou sugestões específicas, entre em contato conosco para compartilhar suas ideias.

​
Configurando o Proxy

Para integrar a funcionalidade de proxy, configure seu cliente especificando o proxyUrl em suas configurações: 
import { sunra } from "@sunra/client";

sunra.config({
  proxyUrl: "/api/sunra/proxy",
});
Essa configuração garante que as chamadas de API sejam roteadas através do seu servidor, aumentando a segurança e simplificando o desenvolvimento.