雖然 Sunra 的 API 端點可以直接從客戶端程式碼存取,但在這樣的環境中儲存 API 金鑰會帶來重大的安全風險。為了解決這個問題,開發人員通常會建立自訂的伺服器端 API,在將結果傳回客戶端之前,安全地與像 Sunra 這樣的第三方服務互動。雖然這種方法有效,但它常常會分散團隊專注於其核心業務目標的注意力。 為簡化此流程,我們開發了支援代理模式的客戶端函式庫。此功能讓您能夠在前端程式碼中利用客戶端函式庫,同時將 API 金鑰安全地保留在您的伺服器端基礎設施中。

預先建置的代理程式解決方案

我們為幾個熱門的框架提供預先建置的代理程式解決方案:
  • Node.js with Next.js:一個 Next.js API 路由處理常式,可用於任何 Next.js 應用程式。它支援 PageApp 路由器。我們自己在所有生產環境中的應用程式都使用它。
  • Node.js with Express:一個 Express 路由處理常式,可用於任何 Express 應用程式。您也可以實作自訂邏輯並與您自己的處理常式組合。
我們致力於根據社群的回饋擴展我們的產品。如果您有特定的請求或建議,請與我們聯絡分享您的想法。

設定代理程式

若要整合代理程式功能,請在您的設定中指定 proxyUrl 來設定您的客戶端:
import { sunra } from "@sunra/client";

sunra.config({
  proxyUrl: "/api/sunra/proxy",
});
此設定可確保 API 呼叫透過您的伺服器路由,從而增強安全性並簡化開發。