Bewertungen

Die /api/queens/evaluations-Endpunkte ermöglichen die Erfassung und Abfrage von Feldbewertungen der Königinnen. BeePass verwendet 8 Merkmale für die genetische Bewertung.

Endpunkte

Methode	Route	Beschreibung
GET	/api/queens/evaluations	Liste der Bewertungen
POST	/api/queens/evaluations	Bewertung erstellen
GET	/api/queens/evaluations/[id]	Bewertungsdetail
PUT	/api/queens/evaluations/[id]	Bewertung bearbeiten
DELETE	/api/queens/evaluations/[id]	Bewertung löschen
POST	/api/queens/evaluations/bulk	Batch-Import (max. 200)

Felder

Feld	Typ	Pflicht	Beschreibung
queen_id	uuid	Ja	ID der bewerteten F0-Königin
eval_year	integer	Ja	Bewertungsjahr
honey_yield_kg	number	Nein	Honigertrag (kg)
gentleness	1-4	Nein	Sanftmut
vigor	1-4	Nein	Vitalität
wintering	1-4	Nein	Überwinterung
swarming	1-4	Nein	Schwarmträgheit
comb_sitting	1-4	Nein	Wabensitz
hyg6_cleaned	0-50	Nein	Gereinigte Zellen nach 6h (Nadeltest)
hyg24_cleaned	0-50	Nein	Gereinigte Zellen nach 24h (Nadeltest)
country_code	string	Nein	Ländercode (ISO 3166)
postal_code	string	Nein	Postleitzahl des Bienenstands

Ordinale Merkmale

Die Merkmale gentleness, vigor, wintering, swarming und comb_sitting verwenden eine Skala von 1 (schlecht) bis 4 (ausgezeichnet). Die Hygiene-Merkmale (hyg6_cleaned, hyg24_cleaned) geben die Anzahl der gereinigten Zellen von 50 an (Nadeltest).

Batch-Import

Der Bulk-Endpoint akzeptiert ein Array von Bewertungen (maximal 200 pro Anfrage):

POST /api/queens/evaluations/bulk

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

• Das Feld owner_id wird serverseitig erzwungen (authentifizierte Sitzung)
• Das Feld evaluation_source wird automatisch auf import gesetzt
• Ungültige Bewertungen werden einzeln abgelehnt (gültige werden eingefügt)

---

Siehe auch: Königinnen | EBV | Export