메인 콘텐츠로 건너뛰기

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.

Sunra의 API 엔드포인트는 클라이언트 측 코드에서 직접 액세스할 수 있지만 이러한 환경에 API 키를 저장하면 심각한 보안 위험이 따릅니다. 이 문제를 해결하기 위해 개발자는 일반적으로 클라이언트에 결과를 반환하기 전에 Sunra와 같은 타사 서비스와 안전하게 상호 작용하는 사용자 지정 서버 측 API를 만듭니다. 이 접근 방식은 효과적이지만 팀이 핵심 비즈니스 목표에 집중하는 데 방해가 되는 경우가 많습니다. 이 프로세스를 간소화하기 위해 프록시 모드를 지원하는 클라이언트 라이브러리를 개발했습니다. 이 기능을 사용하면 서버 측 인프라 내에서 API 키를 안전하게 유지하면서 프런트엔드 코드에서 클라이언트 라이브러리를 활용할 수 있습니다.

​
사전 구축된 프록시 솔루션

널리 사용되는 여러 프레임워크에 대해 사전 구축된 프록시 솔루션을 제공합니다.
  • Next.js가 포함된 Node.js: 모든 Next.js 앱에서 사용할 수 있는 Next.js API 라우트 핸들러입니다. 페이지 및 앱 라우터를 모두 지원합니다. 프로덕션 환경의 모든 앱에서 직접 사용합니다.
  • Express가 포함된 Node.js: 모든 Express 앱에서 사용할 수 있는 Express 라우트 핸들러입니다. 사용자 지정 논리를 구현하고 자체 핸들러와 함께 구성할 수도 있습니다.
커뮤니티 피드백을 바탕으로 제품을 확장하기 위해 최선을 다하고 있습니다. 구체적인 요청이나 제안이 있는 경우 문의하기를 통해 의견을 공유해 주세요.

​
프록시 설정

프록시 기능을 통합하려면 설정에서 proxyUrl을 지정하여 클라이언트를 구성합니다. 
import { sunra } from "@sunra/client";

sunra.config({
  proxyUrl: "/api/sunra/proxy",
});
이 설정은 API 호출이 서버를 통해 라우팅되도록 하여 보안을 강화하고 개발을 간소화합니다.