Q
API

API: Вакансии

Эндпоинты tRPC для управления вакансиями: создание, обновление, получение статистики и управление откликами.

Список вакансий

tRPC Queryvacancy.list

Возвращает список вакансий с количеством реальных откликов.

Параметры

workspaceIdstringобязательный

ID workspace

Пример ответа

{
  "id": "0190abcd123456789",
  "workspaceId": "ws_123",
  "title": "Frontend-разработчик",
  "url": "https://hh.ru/vacancy/123456",
  "views": 1250,
  "responses": 89,
  "newResponses": 12,
  "resumesInProgress": 5,
  "suitableResumes": 23,
  "region": "Москва",
  "description": "Ищем опытного Frontend-разработчика...",
  "requirements": ["React от 3 лет", "TypeScript", "English B2+"],
  "source": "hh.ru",
  "externalId": "123456",
  "customBotInstructions": "Обращайся к кандидатам по имени",
  "customScreeningPrompt": "Обрати внимание на опыт с React",
  "customInterviewQuestions": ["Расскажи о сложном проекте"],
  "customOrganizationalQuestions": ["Почему выбрал нашу компанию?"],
  "isActive": true,
  "realResponsesCount": 89,
  "createdAt": "2025-01-05T09:00:00.000Z",
  "updatedAt": "2025-01-14T15:30:00.000Z"
}

Получение вакансии

tRPC Queryvacancy.get

Возвращает полные данные вакансии по ID.

Параметры

workspaceIdstringобязательный

ID workspace

idstringобязательный

ID вакансии

Пример ответа

{
  "id": "0190abcd123456789",
  "title": "Frontend-разработчик",
  "description": "Полное описание вакансии...",
  "requirements": ["React от 3 лет", "TypeScript", "English B2+"],
  "region": "Москва",
  "salary": {
    "from": 150000,
    "to": 250000,
    "currency": "RUB"
  },
  "customBotInstructions": "Обращайся к кандидатам по имени",
  "customScreeningPrompt": "Обрати внимание на опыт с React",
  "isActive": true,
  "createdAt": "2025-01-05T09:00:00.000Z",
  "updatedAt": "2025-01-14T15:30:00.000Z"
}

Создание вакансии

tRPC Mutationvacancy.create

Создает новую вакансию в workspace.

Параметры

workspaceIdstringобязательный

ID workspace

titlestringобязательный

Название вакансии

descriptionstringобязательный

Описание вакансии

requirementsstring[]

Требования к кандидату

regionstring

Регион или город

customBotInstructionsstring

Инструкции для AI-ассистента

Пример ответа

{
  "id": "0190abcd123456790",
  "title": "Backend-разработчик",
  "workspaceId": "ws_123",
  "isActive": true,
  "createdAt": "2025-01-14T16:00:00.000Z",
  "updatedAt": "2025-01-14T16:00:00.000Z"
}

Статистика вакансии

tRPC Queryvacancy.analytics

Возвращает аналитику по вакансии: воронку, конверсию, источники.

Параметры

workspaceIdstringобязательный

ID workspace

vacancyIdstringобязательный

ID вакансии

periodobject

Период для анализа {from, to}

Пример ответа

{
  "vacancyId": "0190abcd123456789",
  "period": {
    "from": "2025-01-01",
    "to": "2025-01-14"
  },
  "funnel": {
    "new": 120,
    "screening_done": 95,
    "interview": 32,
    "technical_interview": 15,
    "offer_sent": 3,
    "onboarding": 1
  },
  "conversionRate": 0.83,
  "avgTimeToHire": 18,
  "sources": {
    "hh.ru": 78,
    "kwork": 17,
    "telegram": 12
  }
}

Совет

Используйте эндпоинт статистики для построения собственных дашбордов или интеграции с BI-системами.
←КандидатыВернуться к началу→