Zum Hauptinhalt springen

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

MethodeRouteBeschreibung
GET/api/queens/evaluationsListe der Bewertungen
POST/api/queens/evaluationsBewertung 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/bulkBatch-Import (max. 200)

Felder

FeldTypPflichtBeschreibung
queen_iduuidJaID der bewerteten F0-Königin
eval_yearintegerJaBewertungsjahr
honey_yield_kgnumberNeinHonigertrag (kg)
gentleness1-4NeinSanftmut
vigor1-4NeinVitalität
wintering1-4NeinÜberwinterung
swarming1-4NeinSchwarmträgheit
comb_sitting1-4NeinWabensitz
hyg6_cleaned0-50NeinGereinigte Zellen nach 6h (Nadeltest)
hyg24_cleaned0-50NeinGereinigte Zellen nach 24h (Nadeltest)
country_codestringNeinLändercode (ISO 3166)
postal_codestringNeinPostleitzahl 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