tRPC End-to-End Type Safe APIs · Урок

Обзор основных концепций tRPC

Получите общее представление об архитектуре tRPC, включая маршрутизаторы, процедуры и контекст.

«Обзор основных концепций tRPC» — бесплатный урок tRPC End-to-End Type Safe APIs на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения tRPC End-to-End Type Safe APIs, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс tRPC End-to-End Type Safe APIs содержит 4 уроков всего.

Части этого урока еще не переведены и отображаются на английском.

tRPC Core Concepts Intro

Time for tRPC's building blocks. We'll cover routers (how the API is organized), procedures (the functions clients call), and context (per-request data).

tRPC Flow: Client to Server

The tRPC flow: the client calls a procedure, the router routes it, the procedure runs (often using context), and a typesafe response goes back to the client.

Meet tRPC Routers

Routers are the backbone of a tRPC API. They group related procedures into modules, define your API structure, and can be merged into one full API.

Simple Router Structure

A router is just an object holding your callable functions. Here's a conceptual sketch of a minimal user router you'll fill with procedures.

import { router, publicProcedure } from '../trpc';

// This is a conceptual router definition.
// 'router' and 'publicProcedure' would be defined in your tRPC setup file.
export const userRouter = router({
  // All user-related procedures will be defined here
  // e.g., 'getUser', 'createUser', 'updateUser'
});

Understanding Procedures

Procedures are the actual functions your client calls — your API endpoints. Each defines its input, its output, and the server-side business logic.

Queries for Data Fetching

A query procedure fetches data. It should be read-only and idempotent — same input, same result — making it ideal for client-side caching. Like an HTTP GET.

Basic Query Procedure

Here's a conceptual query that fetches a user by ID: it declares an input and returns a user object.

// Inside your userRouter (from previous scene)
// This procedure gets a user by ID.
getUserById: publicProcedure
  .input(z.string()) // Expects a string (the user ID)
  .query(({ input }) => {
    // In a real app, you'd fetch from a database here.
    // For now, imagine we're returning a simple object.
    return { id: input, name: "Jane Doe", email: "jane@example.com" };
  }),

Mutations for Data Changes

A mutation changes data — create, update, delete. It has side effects and isn't idempotent, so repeated calls can differ. Like an HTTP POST, PUT, or DELETE.

tRPC Context Explained

Context is built once per request and passed to every procedure in it. It's where you stash request-scoped data like the auth user or a DB connection.

Core Concepts Check

Let's quickly check your understanding of tRPC's core building blocks.

Core Concepts Recap

Recap: routers organize the API, procedures (queries for reads, mutations for writes) do the work, and context shares per-request data. Next: your first project.

Часто задаваемые вопросы

Урок «Обзор основных концепций tRPC» бесплатный?

Да — полный текст урока «Обзор основных концепций tRPC» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс tRPC End-to-End Type Safe APIs, подпишись на CoddyKit PRO. Курс tRPC End-to-End Type Safe APIs содержит 4 уроков всего.

Чему я научусь в уроке «Обзор основных концепций tRPC»?

Получите общее представление об архитектуре tRPC, включая маршрутизаторы, процедуры и контекст. Ты практикуешь tRPC End-to-End Type Safe APIs с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать tRPC End-to-End Type Safe APIs?

Предыдущий опыт не требуется. tRPC End-to-End Type Safe APIs на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.

Сколько времени занимает урок «Обзор основных концепций tRPC»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке tRPC End-to-End Type Safe APIs?

Да. Каждый урок tRPC End-to-End Type Safe APIs включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к tRPC End-to-End Type Safe APIs