Vai al contenuto principale

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.

Sebbene sia possibile accedere direttamente agli endpoint API di Sunra dal codice lato client, l’archiviazione delle chiavi API in tali ambienti comporta rischi significativi per la sicurezza. Per risolvere questo problema, gli sviluppatori in genere creano API lato server personalizzate che interagiscono in modo sicuro con servizi di terze parti come Sunra prima di restituire i risultati al client. Sebbene efficace, questo approccio spesso distoglie i team dalla concentrazione sui loro obiettivi di business principali. Per semplificare questo processo, abbiamo sviluppato librerie client che supportano una modalità proxy. Questa funzione consente di utilizzare le librerie client nel codice del frontend mantenendo le chiavi API al sicuro all’interno dell’infrastruttura lato server.

​
Soluzioni proxy predefinite

Offriamo soluzioni proxy predefinite per diversi framework popolari:
  • Node.js con Next.js: un gestore di route API di Next.js che può essere utilizzato in qualsiasi app Next.js. Supporta sia i router Page che App. Lo usiamo noi stessi in tutte le nostre app in produzione.
  • Node.js con Express: un gestore di route Express che può essere utilizzato in qualsiasi app Express. È inoltre possibile implementare una logica personalizzata e comporla insieme ai propri gestori.
Ci impegniamo ad espandere le nostre offerte in base al feedback della community. Se hai richieste o suggerimenti specifici, ti preghiamo di contattarci per condividere le tue idee.

​
Impostazione del proxy

Per integrare la funzionalità proxy, configura il tuo client specificando il proxyUrl nelle tue impostazioni: 
import { sunra } from "@sunra/client";

sunra.config({
  proxyUrl: "/api/sunra/proxy",
});
Questa configurazione garantisce che le chiamate API vengano instradate attraverso il tuo server, migliorando la sicurezza e semplificando lo sviluppo.