Evaluaties

De /api/queens/evaluations-endpoints laten u veldevaluaties van koninginnen vastleggen en ophalen. BeePass gebruikt 8 kenmerken voor genetische evaluatie.

Endpoints

Methode	Route	Beschrijving
GET	/api/queens/evaluations	Evaluaties weergeven
POST	/api/queens/evaluations	Een evaluatie aanmaken
GET	/api/queens/evaluations/[id]	Evaluatiedetail
PUT	/api/queens/evaluations/[id]	Een evaluatie bijwerken
DELETE	/api/queens/evaluations/[id]	Een evaluatie verwijderen
POST	/api/queens/evaluations/bulk	Batchimport (max 200)

Velden

Veld	Type	Vereist	Beschrijving
queen_id	uuid	Ja	ID van de geëvalueerde F0-koningin
eval_year	integer	Ja	Evaluatiejaar
honey_yield_kg	number	Nee	Honingproductie (kg)
gentleness	1-4	Nee	Zachtaardigheid
vigor	1-4	Nee	Vitaliteit
wintering	1-4	Nee	Overwintering
swarming	1-4	Nee	Niet-zwermneiging
comb_sitting	1-4	Nee	Raatvastheid
hyg6_cleaned	0-50	Nee	Cellen opgeruimd na 6u (Pin Test)
hyg24_cleaned	0-50	Nee	Cellen opgeruimd na 24u (Pin Test)
country_code	string	Nee	Landcode (ISO 3166)
postal_code	string	Nee	Postcode van de bijenstand

Ordinale kenmerken

De kenmerken gentleness, vigor, wintering, swarming en comb_sitting gebruiken een schaal van 1 (slecht) tot 4 (uitstekend). De hygiënekenmerken (hyg6_cleaned, hyg24_cleaned) vertegenwoordigen het aantal opgeruimde cellen van de 50 (Pin Test).

Batchimport

Het bulk-endpoint accepteert een array van evaluaties (maximaal 200 per verzoek):

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
  }
]

• Het veld owner_id wordt server-side afgedwongen (geauthenticeerde sessie)
• Het veld evaluation_source wordt automatisch ingesteld op import
• Ongeldige evaluaties worden individueel afgewezen (geldige worden ingevoegd)

---

Zie ook: Koninginnen | EBV | Export