Q
API

tRPC API

QBS Автонайм использует tRPC для типобезопасного взаимодействия между клиентом и сервером. Все API методы автоматически типизированы и доступны через tRPC клиент.

Обзор

  • Протокол — tRPC через HTTPS
  • Формат данных — JSON
  • Аутентификация — Сессии через NextAuth
  • Типизация — Полная TypeScript типизация из коробки
  • Валидация — Zod v4 схемы для всех входных данных

Базовый URL

tRPC Endpointtext
http://localhost:3000/api/trpc

Для production используйте ваш домен: https://your-domain.com/api/trpc

Аутентификация

tRPC API использует сессионную аутентификацию через NextAuth. Для доступа необходимо:

  1. Войти в систему через веб-интерфейс
  2. Использовать tRPC клиент с автоматической передачей cookies
  3. Указывать workspaceId в запросах, требующих контекста workspace

Типобезопасность

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

Доступные роутеры

API организован в 20 доменных роутеров:

analytics

Дашборды, статистика, экспорт данных

candidates

Управление кандидатами, этапы, комментарии

chat

AI-ассистент, сообщения, сессии чата

company

Информация о компании

custom-domain

Настройка кастомных доменов

files

Загрузка и управление файлами

freelance-platforms

Интеграция с фриланс-платформами

funnel

Управление воронкой найма

gig

Gig-задания и отклики

integration

Настройка интеграций (HH.ru и др.)

organization

Управление организацией

prequalification

Преквалификация кандидатов

recruiter-agent

AI-агент рекрутера

telegram

Telegram-бот и интервью

test

Тестовые методы (только dev)

user

Профиль пользователя

utils

Вспомогательные методы

vacancy

Управление вакансиями

widget-config

Настройка виджетов

workspace

Управление workspace и участниками

Структура API

Каждый роутер содержит набор процедур (query для чтения, mutation для изменения данных). Все процедуры валидируются через Zod схемы и автоматически типизированы.
←АналитикаИнтеграции→