8. n8n API
Общая информация
Бэкенд приложения HRoom полностью размещен на сервере api.hroom.ai и построен с использованием платформы n8n.
Что такое n8n?
n8n - это открытая платформа автоматизации рабочих процессов, которая позволяет визуально создавать, интегрировать и запускать рабочие процессы без написания кода. Это мощный инструмент, который позволяет связывать различные сервисы и API, обрабатывать данные и автоматизировать бизнес-процессы.
Ключевые особенности n8n:
- Визуальный редактор процессов - интуитивно понятный интерфейс для создания рабочих процессов
- Большое количество интеграций - готовые коннекторы для сотен сервисов и API
- Гибкость и расширяемость - возможность создания собственных узлов и интеграций
- Возможность запуска по расписанию - автоматическое выполнение процессов в определенное время
- Обработка ошибок - механизмы обработки исключений и ошибок
Архитектура бэкенда HRoom
Бэкенд приложения HRoom построен на основе n8n с использованием базы данных PostgreSQL. Такая архитектура обеспечивает гибкость, масштабируемость и надежность системы.
Основные компоненты бэкенда:
- n8n сервер - обрабатывает API-запросы и выполняет рабочие процессы
- PostgreSQL - реляционная база данных для хранения всех данных приложения
- API endpoints - набор конечных точек для взаимодействия с фронтендом
- Cron-задачи - процессы, выполняемые по расписанию
В рамках каждого API-процесса n8n выполняет следующие шаги:
- Принимает HTTP-запрос от клиента
- Проверяет аутентификацию и авторизацию
- Извлекает и валидирует параметры запроса
- Выполняет бизнес-логику (запросы к БД, обработка данных и т.д.)
- Формирует ответ и отправляет его клиенту
Обзор API-endpoints
API-сервер HRoom предоставляет множество конечных точек для различных функций приложения. Каждая API-endpoint обрабатывает определенный тип запросов и отвечает за конкретную часть функциональности:
Translations API
API для получения переводов из базы данных с гибкой фильтрацией по ключу и типу.
ПодробнееUnsubscribe API
API для управления подписками сотрудников и менеджеров с авторизацией по токену.
ПодробнееQuestions API
API для получения данных опросов с различными фильтрами и агрегацией результатов.
ПодробнееAI Sync Data
Workflow для обработки данных опросов сотрудников и генерации аналитических инсайтов.
ПодробнееProfile API
API для управления профилями пользователей и компаний с авторизацией по токену.
ПодробнееAuth API
Полноценная система аутентификации с регистрацией, активацией аккаунта, восстановлением пароля и авторизацией.
ПодробнееAI Get API
API для получения данных искусственного интеллекта с фильтрацией по различным параметрам.
ПодробнееEmployees API
CRUD API для управления сотрудниками компании с авторизацией по токену и расширенными возможностями фильтрации.
ПодробнееEngagement Score API
API для расчета показателей вовлеченности сотрудников на основе данных опросов.
ПодробнееSurvey Send API
Прием и обработка данных опроса с валидацией пользователя и обновлением статистики опроса.
ПодробнееПолный список API-endpoint можно найти в соответствующих разделах документации.