Naar hoofdinhoud gaan

Evaluaties

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

Endpoints

MethodeRouteBeschrijving
GET/api/queens/evaluationsEvaluaties weergeven
POST/api/queens/evaluationsEen 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/bulkBatchimport (max 200)

Velden

VeldTypeVereistBeschrijving
queen_iduuidJaID van de geëvalueerde F0-koningin
eval_yearintegerJaEvaluatiejaar
honey_yield_kgnumberNeeHoningproductie (kg)
gentleness1-4NeeZachtaardigheid
vigor1-4NeeVitaliteit
wintering1-4NeeOverwintering
swarming1-4NeeNiet-zwermneiging
comb_sitting1-4NeeRaatvastheid
hyg6_cleaned0-50NeeCellen opgeruimd na 6u (Pin Test)
hyg24_cleaned0-50NeeCellen opgeruimd na 24u (Pin Test)
country_codestringNeeLandcode (ISO 3166)
postal_codestringNeePostcode 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