Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt

Use this file to discover all available pages before exploring further.

Bien que les points de terminaison de l’API de Sunra puissent être accédés directement depuis le code côté client, le stockage des clés API dans de tels environnements présente des risques de sécurité importants. Pour y remédier, les développeurs créent généralement des API côté serveur personnalisées qui interagissent en toute sécurité avec des services tiers comme Sunra avant de renvoyer les résultats au client. Bien qu’efficace, cette approche détourne souvent les équipes de leurs objectifs commerciaux principaux. Pour rationaliser ce processus, nous avons développé des bibliothèques clientes qui prennent en charge un mode proxy. Cette fonctionnalité vous permet d’utiliser les bibliothèques clientes dans votre code frontal tout en conservant les clés API en toute sécurité au sein de votre infrastructure côté serveur.

​
Solutions de proxy prédéfinies

Nous proposons des solutions de proxy prédéfinies pour plusieurs frameworks populaires :
  • Node.js avec Next.js : un gestionnaire de route API Next.js qui peut être utilisé dans n’importe quelle application Next.js. Il prend en charge les routeurs Page et App. Nous l’utilisons nous-mêmes dans toutes nos applications en production.
  • Node.js avec Express : un gestionnaire de route Express qui peut être utilisé dans n’importe quelle application Express. Vous pouvez également implémenter une logique personnalisée et la composer avec vos propres gestionnaires.
Nous nous engageons à élargir nos offres en fonction des commentaires de la communauté. Si vous avez des demandes ou des suggestions spécifiques, veuillez nous contacter pour nous faire part de vos réflexions.

​
Configuration du proxy

Pour intégrer la fonctionnalité de proxy, configurez votre client en spécifiant le proxyUrl dans vos paramètres : 
import { sunra } from "@sunra/client";

sunra.config({
  proxyUrl: "/api/sunra/proxy",
});
Cette configuration garantit que les appels d’API sont acheminés via votre serveur, ce qui améliore la sécurité et simplifie le développement.