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

Metodo	Rota	Descricao
GET	/api/queens/evaluations	Listar avaliacoes
POST	/api/queens/evaluations	Criar 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/bulk	Importacao em lote (max 200)

Campos

Campo	Tipo	Obrigatorio	Descricao
queen_id	uuid	Sim	ID da rainha F0 avaliada
eval_year	integer	Sim	Ano da avaliacao
honey_yield_kg	number	Nao	Producao de mel (kg)
gentleness	1-4	Nao	Mansidao
vigor	1-4	Nao	Vitalidade
wintering	1-4	Nao	Invernagem
swarming	1-4	Nao	Nao-enxameacao
comb_sitting	1-4	Nao	Fixacao nos quadros
hyg6_cleaned	0-50	Nao	Celulas limpas apos 6h (Pin Test)
hyg24_cleaned	0-50	Nao	Celulas limpas apos 24h (Pin Test)
country_code	string	Nao	Codigo de pais (ISO 3166)
postal_code	string	Nao	Codigo 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