Ir para o conteudo principal

Avaliacoes

Os endpoints /api/queens/evaluations permitem-lhe registar e consultar avaliacoes de campo de rainhas. O BeePass utiliza 8 caracteristicas para avaliacao genetica.

Endpoints

MetodoRotaDescricao
GET/api/queens/evaluationsListar avaliacoes
POST/api/queens/evaluationsCriar uma avaliacao
GET/api/queens/evaluations/[id]Detalhe da avaliacao
PUT/api/queens/evaluations/[id]Atualizar uma avaliacao
DELETE/api/queens/evaluations/[id]Eliminar uma avaliacao
POST/api/queens/evaluations/bulkImportacao em lote (max 200)

Campos

CampoTipoObrigatorioDescricao
queen_iduuidSimID da rainha F0 avaliada
eval_yearintegerSimAno da avaliacao
honey_yield_kgnumberNaoProducao de mel (kg)
gentleness1-4NaoMansidao
vigor1-4NaoVitalidade
wintering1-4NaoInvernagem
swarming1-4NaoNao-enxameacao
comb_sitting1-4NaoFixacao nos quadros
hyg6_cleaned0-50NaoCelulas limpas apos 6h (Pin Test)
hyg24_cleaned0-50NaoCelulas limpas apos 24h (Pin Test)
country_codestringNaoCodigo de pais (ISO 3166)
postal_codestringNaoCodigo postal do apiario
Caracteristicas ordinais

As caracteristicas gentleness, vigor, wintering, swarming e comb_sitting utilizam uma escala de 1 (mau) a 4 (excelente). As caracteristicas de higiene (hyg6_cleaned, hyg24_cleaned) representam o numero de celulas limpas em 50 (Pin Test).

Importacao em lote

O endpoint bulk aceita um array de avaliacoes (maximo 200 por pedido):

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
}
]
  • O campo owner_id e imposto do lado do servidor (sessao autenticada)
  • O campo evaluation_source e automaticamente definido como import
  • Avaliacoes invalidas sao rejeitadas individualmente (as validas sao inseridas)

Ver tambem: Rainhas | EBV | Exportacao