Оценки

Конечные точки /api/queens/evaluations позволяют записывать и получать полевые оценки маток. BeePass использует 8 признаков для генетической оценки.

Конечные точки

Метод	Маршрут	Описание
GET	/api/queens/evaluations	Список оценок
POST	/api/queens/evaluations	Создание оценки
GET	/api/queens/evaluations/[id]	Детали оценки
PUT	/api/queens/evaluations/[id]	Обновление оценки
DELETE	/api/queens/evaluations/[id]	Удаление оценки
POST	/api/queens/evaluations/bulk	Пакетный импорт (макс. 200)

Поля

Поле	Тип	Обязательно	Описание
queen_id	uuid	Да	ID оцениваемой матки F0
eval_year	integer	Да	Год оценки
honey_yield_kg	number	Нет	Медопродуктивность (кг)
gentleness	1-4	Нет	Миролюбие
vigor	1-4	Нет	Сила развития
wintering	1-4	Нет	Зимовка
swarming	1-4	Нет	Неройливость
comb_sitting	1-4	Нет	Поведение на соте
hyg6_cleaned	0-50	Нет	Ячейки, очищенные за 6 ч (Pin Test)
hyg24_cleaned	0-50	Нет	Ячейки, очищенные за 24 ч (Pin Test)
country_code	string	Нет	Код страны (ISO 3166)
postal_code	string	Нет	Почтовый индекс пасеки

Порядковые признаки

Признаки gentleness, vigor, wintering, swarming и comb_sitting используют шкалу от 1 (плохо) до 4 (отлично). Гигиенические признаки (hyg6_cleaned, hyg24_cleaned) представляют количество очищенных ячеек из 50 (Pin Test).

Пакетный импорт

Конечная точка bulk принимает массив оценок (максимум 200 за запрос):

POST /api/queens/evaluations/bulk

[
  {
    "queen_id": "uuid-queen-1",
    "eval_year": 2025,
    "honey_yield_kg": 32.5,
    "gentleness": 3,
    "vigor": 4
  },
  {
    "queen_id": "uuid-queen-2",
    "eval_year": 2025,
    "honey_yield_kg": 28.0,
    "hyg6_cleaned": 42,
    "hyg24_cleaned": 48
  }
]

• Поле owner_id устанавливается принудительно на стороне сервера (аутентифицированная сессия)
• Поле evaluation_source автоматически устанавливается как import
• Невалидные оценки отклоняются по отдельности (валидные вставляются)

---

См. также: Матки | EBV | Экспорт