클라이언트 개요

비공식 베타 번역

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

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

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

React를 사용 중이라면 React Query 통합을 사용하는 것이 tRPC API 호출에 가장 효과적입니다. 이 통합은 타입 안전한 API 호출 외에도 캐싱, 무효화, 로딩 및 오류 상태 관리를 제공합니다. /pages 디렉터리를 사용하는 Next.js 환경에서는 Next.js 통합을 사용할 수 있으며, 여기에는 React Query 통합에 더해 서버 사이드 렌더링과 정적 생성을 위한 도우미 기능이 포함됩니다.

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

React 및 Next.js 통합과 Vanilla Client 외에도 다양한 프레임워크용 커뮤니티 제작 통합이 존재합니다. 단, 이들은 tRPC 팀에서 유지보수하지 않는다는 점에 유의하세요.