logo
  • Proces
  • Case studies
  • Blog
  • O nas
Napisz do nas
  1. Strona główna

  2. /

    Blog

  3. /

    Wprowadzenie do TRPC- budowanie efektywnego API

Wprowadzenie do TRPC- budowanie efektywnego API

fullstack

3 minuty czytania

Tomasz Kozon

19 kwi 2024

typescriptnodejsapi

Tworzenie bezpiecznych API jest nieodzownym elementem każdej aplikacji, a jedną z korzystnych technologii jest TRPC. W tym artykule pokroimy temat pierwszych kroków w budowaniu API z użyciem TRPC.

Spis treści

Planowanie struktury API

Instalacja i podstawowa konfiguracja TRPC

Konfiguracja TRPC po stronie klienta

Podsumowanie

TRPC

Powiązane case studies

SAO Life - aplikacja lojalnościowa dla klientów marki premium

Mobile development, Web development

Uczciwe opłaty - Platforma porównywania kosztów mieszkaniowych

Web development

Pokaż wszystkie case study

Umów się na bezpłatną konsultację

Twoje dane przetwarzamy zgodnie z naszą polityką prywatności.

TRPC to biblioteka, która upraszcza budowę bezpiecznych i wydajnych API, umożliwiając efektywne budowanie aplikacji. Używając TRPC, programiści mogą skupić się na pisaniu funkcji zamiast manualnym tworzeniu i obsłudze endpointów, co czyni proces tworzenia API szybszym i bardziej efektywnym. Ważne jest zapoznanie się z podstawowymi konceptami przetwarzania zadań zdalnych (TRPC), takimi jak procedury, routery i adaptery. Alternatywą dla niego mogą być takie narzędzia jak GraphQL czy REST, jednak biorąc pod uwagę TypeScript, TRPC wydaje się bardziej efektywnym i intuicyjnym rozwiązaniem.

 

Planowanie struktury API

Planowanie struktury bezpiecznych API jest podstawą każdej nowoczesnej aplikacji. Kluczem jest zrozumienie, jakie dane są przesyłane, gdzie są przechowywane i jak są chronione. To obejmuje zdecydowanie, które dane są publiczne, a które muszą być chronione. Ważnym krokiem jest również zaprojektowanie systemu autoryzacji, który zapewni właściwy dostęp do danych. TRPC zapewnia adaptery do popularnych rozwiązań które mogą być niezwykle przydatne przy tworzeniu logiki odpowiedzialnej za obsługiwanie żądań. Przy tworzeniu routerów biblioteka umożliwia nam tworzenie publicznych oraz zabezpieczonych procedur- które wymagają od użytkownika określonych permisji aby żądania zostały poprawnie obsłużone.

 

Czy szukasz wykonawcy projektów IT ?
logo
Sprawdź case studies

Instalacja i podstawowa konfiguracja TRPC

Konfiguracja środowiska do pracy z TRPC jest pierwszym kluczowym krokiem. Bogate możliwości tej biblioteki ułatwiają tworzenie API opartych na typach i funkcjach. Aby rozpocząć pracę, wymagana jest instalacja odpowiednich paczek przy użyciu preferowanego menadżera paczek, dla przykładu skorzystamy z npm:

 

npm install @trpc/server@next @trpc/client@next

 

Na początku musimy zdefiniować instancję TRPC:

 

// server

import { initTRPC } from '@trpc/server';
 
const trpc = initTRPC.create();

 

Następnie możemy przejść do stworzenia routera:

 

// server

const appRouter = trpc.router({
	getUser: trpc.publicProcedure.query(async (ctx) => {
		const user = db.user.findFirst(ctx.user)
		
		return user;
	})
})

export type AppRouter = typeof appRouter;
// przyda się dla zainicjowania kodu po stronie klienta

 

W powyższym przykładzie inicjowana jest instancja TRPC do której następnie podłączany jest router, który posiada publiczną procedurę "getUser" która zwraca aktualnego użytkownika na bazie kontekstu. Dodatkowo na końcu eksportowany jest typ całego routera, który przyda się przy implementacji TRPC po stronie klienta. Takie rozwiązanie zapewnia pełne pokrycie typowania w momencie korzystania z API.

 

Konfiguracja TRPC po stronie klienta

Aby w pełni wykorzystać możliwości TRPC musimy również skonfigurować go po stronie klienta.

 

// client

import { createTRPCClient, httpBatchLink } from '@trpc/client';
import type { AppRouter } from './server';
 
export const trpc = createTRPCClient<AppRouter>({
  links: [
    httpBatchLink({
      url: 'http://localhost:3000',
    }),
  ],
});
// client

const user = await trpc.getUser.query();

 

Po zainicjowaniu klienta TRPC, można go używać w dowolnym miejscu w aplikacji po prostu go importując. Dzięki temu otrzymujemy w pełni otypowane procedury i wyniki od poszczególnych routerów i endpointów.

 

Podsumowanie

TRPC to biblioteka, która usprawnia tworzenie bezpiecznych i wydajnych API poprzez abstrakcję obsługi endpointów. Kluczowe koncepcje TRPC to procedury, routery i adaptery, które pomagają utrzymać wysoki poziom bezpieczeństwa. Planowanie struktury API jest kluczowe dla nowoczesnych aplikacji, a TRPC ułatwia tworzenie logiki routerów i procedur. Inicjalizacja i konfiguracja TRPC zarówno po stronie serwera, jak i klienta są kluczowymi krokami w implementacji. Dzięki pełnemu typowaniu, TRPC zapewnia bezproblemową i efektywną obsługę API.

 

FAQ – najczęstsze pytania dotyczące tRPC

1. Czym dokładnie jest tRPC?

tRPC to biblioteka TypeScript umożliwiająca tworzenie API bez potrzeby pisania osobnych typów dla klienta i serwera. Dzięki niej możemy budować pełne typowanie end-to-end bez użycia REST czy GraphQL.

2. Czy tRPC nadaje się do produkcji?

Tak, tRPC jest wykorzystywane w wielu projektach produkcyjnych. Jest aktywnie rozwijane i posiada solidną dokumentację. Należy jednak pamiętać o dobrych praktykach bezpieczeństwa i wydajności.

3. Jak tRPC różni się od REST i GraphQL?

tRPC pozwala na komunikację między klientem a serwerem z pełnym typowaniem, bez potrzeby definiowania schematów. REST i GraphQL wymagają jawnych kontraktów – tRPC opiera się na typach TypeScript.

4. Czy mogę używać tRPC z React?

Tak, tRPC świetnie współpracuje z Reactem, szczególnie z frameworkiem Next.js. Istnieją gotowe hooki ułatwiające integrację z komponentami React.

5. Czy muszę znać TypeScript, żeby korzystać z tRPC?

Zdecydowanie tak. TypeScript jest podstawą działania tRPC i umożliwia automatyczne dziedziczenie typów między serwerem a klientem.

6. Jakie są zalety tRPC w porównaniu do tradycyjnego REST API?

  • Brak konieczności pisania i synchronizowania schematów API
  • Mniej boilerplate'u
  • Lepsze wsparcie dla refaktoryzacji dzięki typom
  • Szybsze prototypowanie i mniej błędów w czasie uruchomienia

7. Czy tRPC wspiera autoryzację i uwierzytelnianie?

Tak, tRPC pozwala na tworzenie warstw middleware, które mogą obsługiwać autoryzację i uwierzytelnianie, np. z użyciem JWT, session cookies czy bibliotek jak next-auth.

8. Czy można korzystać z tRPC poza Next.js?

Tak, chociaż tRPC jest często używane z Next.js, można je zintegrować z innymi środowiskami Node.js – np. Express, Fastify czy Vite.

Nasza oferta

Web development

Dowiedz się więcej

Mobile development

Dowiedz się więcej

E-commerce

Dowiedz się więcej

Projektowanie UX/UI

Dowiedz się więcej

Outsourcing

Dowiedz się więcej

SEO

Dowiedz się więcej

Powiązane artykuły

ButterCMS: Czym jest i dlaczego warto z niego skorzystać?

6 lip 2025

ButterCMS to nowoczesny headless CMS, który pozwala tworzyć i zarządzać treściami w sposób szybki, elastyczny i niezależny od warstwy front-endowej. Dzięki temu programiści mogą budować aplikacje i strony internetowe w dowolnych technologiach, a marketerzy zyskują wygodne narzędzie do publikacji treści. System świetnie sprawdza się zarówno w małych projektach, jak i w dużych serwisach wymagających skalowalności i integracji z innymi rozwiązaniami.

Tomasz Kozon
#fullstack
related-article-image-laptop, cms, ButterCMS

Light Table – lekki, interaktywny edytor kodu

8 cze 2025

Coś, co wywołuje furorę w świecie IT, to Light Table - lekki i interaktywny edytor kodu zyskujący coraz większą popularność. Jego nowatorskie podejście do programowania, które łączy prostotę i interaktywność, zrewolucjonizowało sposób, w jaki myślimy o tworzeniu kodu. Zapraszam do przeczytania reszty artykułu, aby dowiedzieć się więcej o tym, dlaczego Light Table jest nazywany przyszłością programowania.

Tomasz Kozon
#fullstack

TanStack Router: Nowoczesne, w pełni bezpieczne rozwiązanie do routingu dla React

23 maj 2025

TanStack Router to zaawansowane, w pełni bezpieczne narzędzie do routingu dla React. Ten nowoczesny router, wykorzystuje pełen potencjał TypeScript do zgłaszania błędów na etapie kompilacji, znacząco podnosząc bezpieczeństwo i efektywność tworzonych aplikacji. Zainspirowany przez React-Router i Reach-Router, oferuje unikalne cechy, które przyczyniają się do jego rosnącej popularności.

Tomasz Kozon
#front-end

Neovim - edytor kodu. Dlaczego warto mu szansę?

22 maj 2025

Neovim to rewolucja wśród edytorów kodu, łącząca sprawdzone rozwiązania z nowoczesnymi technologiami. Daje nam komfort pracy znanego z Vim dostosowany do wymagań XXI wieku. Czy Neovim to naprawdę next-level kodowania? Pozwól, że Ci to wyjaśniamy i przekonaj się sam, dlaczego warto dać mu szansę.

Tomasz Kozon
#fullstack

Appwrite: wielofunkcyjna platforma do tworzenia aplikacji Backend-as-a-Service

9 maj 2025

Przygoda z tworzeniem aplikacji nigdy nie była prostsza, dzięki Appwrite - nowoczesnej, wielofunkcyjnej platformie Backend-as-a-Service. Co sprawia, że Appwrite wyróżnia się na tle innych rozwiązań typu BaaS? Czy dostosowana do potrzeb developerów funkcjonalność to klucz do sukcesu? Sprawdźmy.

Tomasz Kozon
#back-end

Google App Engine: Czym jest i jak działa?

5 maj 2025

Google App Engine to chmurowa platforma dostarczana przez Google, umożliwiająca deweloperom tworzenie, uruchamianie i rozwój aplikacji w zasobach Google. Znane również jako platforma 'Platform as a Service'(PaaS) oferuje skalowalne narzędzia i usługi, by efektywnie zarządzać pełnym cyklem życia aplikacji. Zrozumienie, jak funkcjonuje, może przynieść duże korzyści dla twojego projektu IT.

Tomasz Kozon
#back-end

Najważniejsze technologie do tworzenia aplikacji webowych na 2025 rok

27 mar 2025

Tworzenie aplikacji webowych zmienia się z roku na rok – pojawiają się nowe narzędzia, frameworki i podejścia, które ułatwiają pracę programistom i poprawiają jakość końcowych produktów. W 2025 roku szczególnie widać nacisk na wydajność, automatyzację i lepsze doświadczenia użytkownika. Technologie stają się coraz bardziej inteligentne, szybkie i dostępne. W tym artykule przedstawiamy najważniejsze trendy i rozwiązania, które kształtują web development w nadchodzącym czasie.

Tomasz Kozon
#fullstack

Zobacz wszystkie artykuły powiązane z #fullstack

Boring Owl Logo

Napisz do nas

Zadzwoń

+48 509 280 539

Oferta

  • Web Development

  • Mobile Development

  • UI/UX Design

  • E-commerce

  • Outsourcing

  • SEO

Menu

  • O nas

  • Case studies

  • FAQ

  • Blog

  • Kariera

  • Kontakt

Software House

  • Software House Warszawa

  • Software House Katowice

  • Software House Lublin

  • Software House Kraków

  • Software House Wrocław

  • Software House Łódź

 

  • Software House Poznań

  • Software House Gdańsk

  • Software House Białystok

  • Software House Gliwice

  • Software House Trójmiasto

Agencje SEO

  • Agencja SEO Warszawa

  • Agencja SEO Kraków

  • Agencja SEO Wrocław

  • Agencja SEO Poznań

  • Agencja SEO Gdańsk

  • Agencja SEO Toruń

© 2025 – Boring Owl – Software House Warszawa

  • adobexd logo
    adobexd
  • algolia logo
    algolia
  • amazon-s3 logo
    amazon-s3
  • android logo
    android
  • angular logo
    angular
  • api logo
    api
  • apscheduler logo
    apscheduler
  • argocd logo
    argocd
  • astro logo
    astro
  • aws-amplify logo
    aws-amplify
  • aws-cloudfront logo
    aws-cloudfront
  • aws-lambda logo
    aws-lambda
  • axios logo
    axios
  • azure logo
    azure
  • bash logo
    bash
  • bootstrap logo
    bootstrap
  • bulma logo
    bulma
  • cakephp logo
    cakephp
  • celery logo
    celery
  • chartjs logo
    chartjs
  • clojure logo
    clojure
  • cloudflare logo
    cloudflare
  • cloudinary logo
    cloudinary
  • cms logo
    cms
  • cobol logo
    cobol
  • contentful logo
    contentful
  • coolify logo
    coolify
  • cpython logo
    cpython
  • css3 logo
    css3
  • django logo
    django
  • django-rest logo
    django-rest
  • docker logo
    docker
  • drupal logo
    drupal
  • dynamodb logo
    dynamodb
  • elasticsearch logo
    elasticsearch
  • electron logo
    electron
  • expo-io logo
    expo-io
  • express-js logo
    express-js
  • fakerjs logo
    fakerjs
  • fastapi logo
    fastapi
  • fastify logo
    fastify
  • figma logo
    figma
  • firebase logo
    firebase
  • flask logo
    flask
  • flutter logo
    flutter
  • gatsbyjs logo
    gatsbyjs
  • ghost-cms logo
    ghost-cms
  • google-cloud logo
    google-cloud
  • graphcms logo
    graphcms
  • graphql logo
    graphql
  • groovy logo
    groovy
  • gtm logo
    gtm
  • gulpjs logo
    gulpjs
  • hasura logo
    hasura
  • headless-cms logo
    headless-cms
  • heroku logo
    heroku
  • html5 logo
    html5
  • httpie logo
    httpie
  • i18next logo
    i18next
  • immutablejs logo
    immutablejs
  • imoje logo
    imoje
  • ios logo
    ios
  • java logo
    java
  • javascript logo
    javascript
  • jekyll logo
    jekyll
  • jekyll-admin logo
    jekyll-admin
  • jenkins logo
    jenkins
  • jquery logo
    jquery
  • json logo
    json
  • keras logo
    keras
  • keystone5 logo
    keystone5
  • kotlin logo
    kotlin
  • kubernetes logo
    kubernetes
  • laravel logo
    laravel
  • lodash logo
    lodash
  • magento logo
    magento
  • mailchimp logo
    mailchimp
  • material-ui logo
    material-ui
  • matlab logo
    matlab
  • maven logo
    maven
  • miro logo
    miro
  • mockup logo
    mockup
  • momentjs logo
    momentjs
  • mongodb logo
    mongodb
  • mysql logo
    mysql
  • nestjs logo
    nestjs
  • net logo
    net
  • netlify logo
    netlify
  • next-js logo
    next-js
  • nodejs logo
    nodejs
  • npm logo
    npm
  • nuxtjs logo
    nuxtjs
  • oracle logo
    oracle
  • pandas logo
    pandas
  • php logo
    php
  • postgresql logo
    postgresql
  • postman logo
    postman
  • prestashop logo
    prestashop
  • prettier logo
    prettier
  • prisma logo
    prisma
  • prismic logo
    prismic
  • prose logo
    prose
  • pwa logo
    pwa
  • python logo
    python
  • python-scheduler logo
    python-scheduler
  • rabbitmq logo
    rabbitmq
  • react-flow logo
    react-flow
  • react-hook-form logo
    react-hook-form
  • react-js logo
    react-js
  • react-native logo
    react-native
  • react-query logo
    react-query
  • react-static logo
    react-static
  • redis logo
    redis
  • redux logo
    redux
  • redux-persist logo
    redux-persist
  • redux-saga logo
    redux-saga
  • redux-thunk logo
    redux-thunk
  • relume logo
    relume
  • restful logo
    restful
  • ruby-on-rails logo
    ruby-on-rails
  • rust logo
    rust
  • rxjs logo
    rxjs
  • saleor logo
    saleor
  • sanity logo
    sanity
  • scala logo
    scala
  • scikit-learn logo
    scikit-learn
  • scrapy logo
    scrapy
  • scrum logo
    scrum
  • selenium logo
    selenium
  • sentry logo
    sentry
  • shodan logo
    shodan
  • shopify logo
    shopify
  • slack logo
    slack
  • sms-api logo
    sms-api
  • socket-io logo
    socket-io
  • solidity logo
    solidity
  • spring logo
    spring
  • sql logo
    sql
  • sql-alchemy logo
    sql-alchemy
  • storyblok logo
    storyblok
  • storybook logo
    storybook
  • strapi logo
    strapi
  • stripe logo
    stripe
  • structured-data logo
    structured-data
  • struts logo
    struts
  • styled-components logo
    styled-components
  • supabase logo
    supabase
  • svelte logo
    svelte
  • swagger logo
    swagger
  • swift logo
    swift
  • symfony logo
    symfony
  • tailwind-css logo
    tailwind-css
  • tensorflow logo
    tensorflow
  • terraform logo
    terraform
  • threejs logo
    threejs
  • twig logo
    twig
  • typescript logo
    typescript
  • vercel logo
    vercel
  • vue-js logo
    vue-js
  • webflow logo
    webflow
  • webpack logo
    webpack
  • websocket logo
    websocket
  • woocommerce logo
    woocommerce
  • wordpress logo
    wordpress
  • yarn logo
    yarn
  • yii logo
    yii
  • zend logo
    zend
  • zeplin logo
    zeplin
  • zustand logo
    zustand