클라이언트 개요

비공식 베타 번역

이 페이지는 PageTurner AI로 번역되었습니다(베타). 프로젝트 공식 승인을 받지 않았습니다. 오류를 발견하셨나요? 문제 신고 →

tRPC API는 다른 REST API와 마찬가지로 일반 HTTP 요청을 사용해 호출할 수 있지만, tRPC의 타입 안전성을 활용하려면 클라이언트가 필요합니다.

클라이언트는 API에서 사용 가능한 프로시저와 해당 입력 및 출력을 알고 있습니다. 이 정보를 기반으로 쿼리 및 뮤테이션 자동 완성을 제공하고, 반환된 데이터의 타입을 정확히 지정하며, 백엔드 구조와 일치하지 않는 요청 작성 시 오류를 표시합니다.

React를 사용 중이라면 tRPC API를 호출하는 권장 방법은 TanStack React Query 통합을 사용하는 것입니다. 이 통합은 타입 안전한 API 호출 외에도 캐싱, 무효화, 로딩 및 오류 상태 관리를 제공합니다. /pages 디렉토리를 사용하는 Next.js를 사용 중이라면 Next.js 통합을 사용할 수 있으며, 이 통합은 서버 사이드 렌더링(SSR)과 정적 생성(Static Generation)을 위한 헬퍼 기능을 추가합니다.

다른 서버나 통합이 제공되지 않는 프론트엔드 프레임워크에서 tRPC API를 호출하려는 경우 Vanilla Client를 사용할 수 있습니다.

React 및 Next.js 통합과 Vanilla Client 외에도 다양한 커뮤니티 제작 통합이 다른 프레임워크용으로 존재합니다. 단, 이러한 통합은 tRPC 팀에서 관리하지 않습니다.