{"openapi":"3.1.0","info":{"title":"LiveHive API","version":"1.1.0","description":"A LiveHive nyilvános API-ja: kaptárak, méhesek, kaptárnapló (átvizsgálások, kezelések, események), aljdeszka-számlálások és jelölések.\n\nHitelesítés: `Authorization: Bearer lh_…` személyes API-tokennel, amelyet a Fiókom oldalon lehet létrehozni.\nJogosultságok: `read` (minden GET), `write` (kaptárak, méhesek, naplóbejegyzések és számlálások létrehozása, módosítása, törlése, a kaptárfotó törlése), `photos:write` (fotó feltöltése: számlálás és kaptárfotó).\nA munkamenet-sütit ezek a végpontok nem fogadják el, CSRF-fejléc nem kell.\n\nKorlátok: tokenenként 120 kérés percenként (429, Retry-After). POST-kérésnél az `Idempotency-Key` fejléccel\negy ismételt kérés ugyanazt a választ kapja 24 óráig, és nem hoz létre új rekordot.\n\nHibák: `{\"error\": {\"code\": \"…\", \"message\": \"…\"}}`; a `code` géppel olvasható és stabil, a `message` magyar nyelvű.\nSzázalékkal kódolt karaktert tartalmazó útvonal 404. Nincs CORS: az API nem böngészőből, más originről hívandó."},"servers":[{"url":"/api/v1"}],"security":[{"bearer":[]}],"paths":{"/openapi.json":{"get":{"summary":"Ez a leírás.","security":[],"responses":{"200":{"description":"OpenAPI 3.1 dokumentum.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/hive-options":{"get":{"summary":"Az adatlap választható értékei (kulcs, magyar címke).","security":[{"bearer":["read"]}],"responses":{"200":{"description":"Értéklisták.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/apiaries":{"get":{"summary":"Méhesek listája.","security":[{"bearer":["read"]}],"responses":{"200":{"description":"Méhesek.","content":{"application/json":{"schema":{"type":"object","properties":{"apiaries":{"type":"array","items":{"$ref":"#/components/schemas/Apiary"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"summary":"Méhes létrehozása.","security":[{"bearer":["write"]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiaryInput"}}}},"responses":{"201":{"description":"A létrehozott méhes.","content":{"application/json":{"schema":{"type":"object","properties":{"apiary":{"$ref":"#/components/schemas/Apiary"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/IdempotencyKeyReused"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/apiaries/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) méhes azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"patch":{"summary":"Méhes módosítása (a hiányzó mező nem változik).","security":[{"bearer":["write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiaryInput"}}}},"responses":{"200":{"description":"A módosított méhes.","content":{"application/json":{"schema":{"type":"object","properties":{"apiary":{"$ref":"#/components/schemas/Apiary"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"delete":{"summary":"Méhes törlése; a kaptárai megmaradnak, méhes nélkül.","security":[{"bearer":["write"]}],"responses":{"204":{"description":"Kész, nincs törzs."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/apiaries/{id}/overview":{"parameters":[{"name":"id","in":"path","required":true,"description":"A méhes azonosítója, vagy `none` a méhes nélküli kaptárak összehasonlításához.","schema":{"oneOf":[{"type":"string","pattern":"^[0-9a-f]{32}$"},{"type":"string","const":"none"}]}}],"get":{"summary":"A méhes kaptárai egymás mellett: legutóbbi családerő, atka/nap, utolsó átvizsgálás.","security":[{"bearer":["read"]}],"description":"Számított, olvasáskor, az as_of utáni sorok nélkül. A természetes és a kezelés alatti hullás külön érték, a természetesbe a kezelés alatt gyűlt számlálás nem kerül. Szabad szöveg nincs benne. Nem lapozott: a kaptárak száma felhasználónként korlátos.","responses":{"200":{"description":"Összehasonlítás.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiaryOverview"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/apiaries/{id}/layout":{"parameters":[{"name":"id","in":"path","required":true,"description":"A méhes azonosítója, vagy `none` a méhes nélküli kaptárak térképéhez.","schema":{"oneOf":[{"type":"string","pattern":"^[0-9a-f]{32}$"},{"type":"string","const":"none"}]}}],"put":{"summary":"A méhestérkép teljes elrendezésének mentése (a kimaradt kaptárak elhelyezetlenek lesznek).","security":[{"bearer":["write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["hives"],"properties":{"hives":{"type":"array","description":"Csak a térkép saját kaptárai, legfeljebb a kaptárkorlátnyi; azonosító és cella egyszer szerepelhet.","items":{"type":"object","required":["id","x","y"],"properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"x":{"type":"integer","minimum":0,"maximum":9},"y":{"type":"integer","minimum":0,"maximum":49},"rotation":{"type":"integer","enum":[0,90,180,270],"default":0}}},"maxItems":200}}}}}},"responses":{"200":{"description":"A mentett elrendezés.","content":{"application/json":{"schema":{"type":"object","properties":{"hives":{"type":"array","items":{"type":"object","required":["id","map_x","map_y","map_rot"],"properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"map_x":{"type":"integer"},"map_y":{"type":"integer"},"map_rot":{"type":"integer","enum":[0,90,180,270]}}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/hives":{"get":{"summary":"Kaptárak listája az utolsó számlálással.","security":[{"bearer":["read"]}],"responses":{"200":{"description":"Kaptárak.","content":{"application/json":{"schema":{"type":"object","properties":{"hives":{"type":"array","items":{"$ref":"#/components/schemas/HiveListItem"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"summary":"Kaptár létrehozása.","security":[{"bearer":["write"]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HiveInput","required":["name"]}}}},"responses":{"201":{"description":"A létrehozott kaptár.","content":{"application/json":{"schema":{"type":"object","properties":{"hive":{"$ref":"#/components/schemas/HiveListItem"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/IdempotencyKeyReused"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/hives/export.csv":{"get":{"summary":"Az összes kaptár adatlapja CSV-ben.","security":[{"bearer":["read"]}],"responses":{"200":{"description":"CSV (UTF-8, BOM).","content":{"text/csv":{"schema":{"type":"string"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/hives/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) kaptár azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"Kaptár adatlapja és számlálásai.","security":[{"bearer":["read"]}],"responses":{"200":{"description":"Kaptár.","content":{"application/json":{"schema":{"type":"object","properties":{"hive":{"$ref":"#/components/schemas/Hive"},"counts":{"type":"array","items":{"$ref":"#/components/schemas/CountSummary"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"summary":"Kaptár módosítása (a hiányzó mező nem változik, a null töröl).","security":[{"bearer":["write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HiveInput"}}}},"responses":{"200":{"description":"A módosított kaptár.","content":{"application/json":{"schema":{"type":"object","properties":{"hive":{"$ref":"#/components/schemas/Hive"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}}},"delete":{"summary":"Kaptár törlése minden számlálásával és fotójával.","security":[{"bearer":["write"]}],"responses":{"204":{"description":"Kész, nincs törzs."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/hives/{id}/history":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) kaptár azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"A kaptár teljes története egy idővonalon, kurzoros lapozással.","security":[{"bearer":["read"]}],"description":"Átvizsgálások, események (kezelés, etetés, pergetés, anya- és családesemény, mérlegelés) és atkaszámlálások, alapból időrendben. Azonos napon a fotó és az időpont nélküli bejegyzés elöl, utána az időpontos bejegyzések; ezután a rögzítés ideje. A fotóhoz kötött atkaszámos `varroa` bejegyzés és a fotó egy `mite_count` tétel: jelölt fotónál (mark_count > 0) a fotó, különben a bejegyzés; a másik fél a `paired` listába kerül. Az adatlap változásai nincsenek benne, mert nem tároljuk a korábbi állapotát; az anya- és családesemények igen.","parameters":[{"name":"from","in":"query","required":false,"description":"Ettől a naptól, a nappal együtt.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Eddig a napig, a nappal együtt.","schema":{"type":"string","format":"date"}},{"name":"kinds","in":"query","required":false,"description":"Fajták vesszővel elválasztva: inspection, treatment, feeding, harvest, queen, colony, weight, mite_count. A `varroa` bejegyzések és a fotós számlálások fajtája `mite_count`.","schema":{"type":"string"}},{"name":"order","in":"query","required":false,"description":"asc: a legrégebbi elöl; desc: a legújabb elöl.","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","required":false,"description":"Az előző válasz next_cursor értéke, változatlanul, ugyanazokkal a szűrőkkel. A kaptárhoz és az order értékéhez kötött: máshol 400 invalid-cursor. Egy közben felvett vagy törölt bejegyzés nem csúsztatja el a lapokat, de egy dátumában módosított tétel, vagy egy közben megjelölt fotó (a pár másik fele lesz az eredmény) két lapon is megjelenhet.","schema":{"type":"string"}},{"name":"include_notes","in":"query","required":false,"description":"true: a szabad szöveges mezők is látszanak (notes, todo, és a data batch, supplier, purchase_ref, vet, prescription_number, queen_source mezője). Alapból rejtve. Más érték, mint true vagy false: 400. Alapból is látszik a készítmény (product), az anya fajtája (queen_breed), a kaptár és a méhes neve és a kaptárszám; a név személy vagy hely nevét is tartalmazhatja, ezt vegye figyelembe, aki LLM-nek adja tovább. Ez a kontextus méretét és az adatvédelmet szolgáló alapérték, nem hozzáférési határ: egy read token ugyanezeket a szövegeket a napló végpontjain is olvashatja.","schema":{"type":"string","enum":["true","false"],"default":"false"}}],"responses":{"200":{"description":"Egy lap az idővonalból.","content":{"application/json":{"schema":{"type":"object","properties":{"hive_id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"timeline":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/HistoryMiteCount"},{"$ref":"#/components/schemas/HistoryEntry"}]}},"next_cursor":{"type":["string","null"],"description":"A következő lap kurzora; null, ha ez az utolsó."}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/hives/{id}/summary":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) kaptár azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"A kaptár tömör, számított összesítője LLM-kontextusnak.","security":[{"bearer":["read"]}],"description":"Olvasáskor számolódik, semmi nem tárolt. A természetes és a kezelés utáni hullás nem keveredik, a jelöletlen fotó nem mérés.","parameters":[{"name":"include_notes","in":"query","required":false,"description":"true: a szabad szöveges mezők is látszanak (notes, todo, és a data batch, supplier, purchase_ref, vet, prescription_number, queen_source mezője). Alapból rejtve. Más érték, mint true vagy false: 400. Alapból is látszik a készítmény (product), az anya fajtája (queen_breed), a kaptár és a méhes neve és a kaptárszám; a név személy vagy hely nevét is tartalmazhatja, ezt vegye figyelembe, aki LLM-nek adja tovább. Ez a kontextus méretét és az adatvédelmet szolgáló alapérték, nem hozzáférési határ: egy read token ugyanezeket a szövegeket a napló végpontjain is olvashatja.","schema":{"type":"string","enum":["true","false"],"default":"false"}}],"responses":{"200":{"description":"Összesítő.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HiveSummary"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/hives/{id}/export.csv":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) kaptár azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"A kaptár számlálásai CSV-ben (dátum, atkaszám).","security":[{"bearer":["read"]}],"responses":{"200":{"description":"CSV (UTF-8, BOM).","content":{"text/csv":{"schema":{"type":"string"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/hives/{id}/inspections":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) kaptár azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"A kaptár naplóbejegyzései, a legújabb elöl.","security":[{"bearer":["read"]}],"parameters":[{"name":"kind","in":"query","required":false,"description":"Csak ez a bejegyzésfajta.","schema":{"type":"string","enum":["inspection","varroa","treatment","feeding","harvest","queen","colony","weight"]}}],"responses":{"200":{"description":"Bejegyzések.","content":{"application/json":{"schema":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/Entry"}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"summary":"Naplóbejegyzés (átvizsgálás vagy esemény) felvétele.","security":[{"bearer":["write"]}],"description":"A fajtától függő mezők közvetlenül a törzsben vagy a `data` objektumban is megadhatók. `varroa` bejegyzésnél `mites` értékkel, hullásos módszernél vagy módszer nélkül az `exposure_days` kötelező (400 missing-exposure_days), kivéve, ha a `treatment_id` kezeléséhez kötve kiszámolható. `update_profile: true` mellett az anya- és családesemény az adatlapra is átvezetődik.","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntryInput","required":["kind","date"]}}}},"responses":{"201":{"description":"A létrehozott bejegyzés.","content":{"application/json":{"schema":{"type":"object","properties":{"entry":{"$ref":"#/components/schemas/Entry"},"profile_updated":{"type":"boolean"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/IdempotencyKeyReused"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/hives/{id}/inspections/export.json":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) kaptár azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"A kaptár naplója és fotós számlálásai időrendben, JSON-ban.","security":[{"bearer":["read"]}],"parameters":[{"name":"kind","in":"query","required":false,"description":"Csak ez a bejegyzésfajta.","schema":{"type":"string","enum":["inspection","varroa","treatment","feeding","harvest","queen","colony","weight"]}}],"responses":{"200":{"description":"Export.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/hives/{id}/inspections/export.csv":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) kaptár azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"A kaptár naplója és fotós számlálásai időrendben, CSV-ben.","security":[{"bearer":["read"]}],"parameters":[{"name":"kind","in":"query","required":false,"description":"Csak ez a bejegyzésfajta.","schema":{"type":"string","enum":["inspection","varroa","treatment","feeding","harvest","queen","colony","weight"]}}],"responses":{"200":{"description":"CSV (UTF-8, BOM).","content":{"text/csv":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/inspection-options":{"get":{"summary":"A napló fajtái, mezői (típus, határok, fajta) és választható értékei.","security":[{"bearer":["read"]}],"responses":{"200":{"description":"Leírás.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/inspections/treatments.csv":{"get":{"summary":"Az összes kaptár kezelési naplója (állatgyógyászati nyilvántartás) CSV-ben.","security":[{"bearer":["read"]}],"responses":{"200":{"description":"CSV (UTF-8, BOM).","content":{"text/csv":{"schema":{"type":"string"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/inspections/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) naplóbejegyzés azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"Naplóbejegyzés.","security":[{"bearer":["read"]}],"responses":{"200":{"description":"Bejegyzés.","content":{"application/json":{"schema":{"type":"object","properties":{"entry":{"$ref":"#/components/schemas/Entry"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"summary":"Naplóbejegyzés módosítása (a hiányzó mező nem változik, a null töröl, a napok kivételével; a fajta nem módosítható). Egy régi, lépésre nem illő tárolt érték (pl. 5,83 keret) csak úgy marad meg, ha a kérés nem tartalmazza a mezőt; visszaküldése 400, ezért a GET-válasz egészét ne küldd vissza, csak a módosuló mezőket (vagy töröld a mezőt null-lal, vagy adj lépésre illő értéket).","security":[{"bearer":["write"]}],"description":"A `varroa` bejegyzés `mites` értékkel, hullásos módszernél (natural_drop, treatment_drop vagy nincs módszer) nem maradhat `exposure_days` nélkül: a napok törlése, napok nélkül hullásos módszerre váltás és a számnélküli bejegyzéshez napok nélkül adott `mites` 400 missing-exposure_days választ ad. Kivétel, ha a bejegyzés kezeléshez kötött, és a napok kiszámolhatók (derived.effective_days). Régi, napok nélküli bejegyzés a módszere megtartásával napok nélkül is módosítható, és egy GET-válasz változatlanul visszaküldhető.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntryInput"}}}},"responses":{"200":{"description":"A módosított bejegyzés.","content":{"application/json":{"schema":{"type":"object","properties":{"entry":{"$ref":"#/components/schemas/Entry"},"counts_without_days":{"type":"array","description":"Csak kezelésnél: a számolt napú számlálások, amelyeknek a módosítás (a kezdet áthelyezése) után nincs napjuk; a napjaikat be kell írni. A kötésük megmarad. `source: entry` naplóbejegyzés, `photo` fotós számlálás; a `varroa` bejegyzéshez kötött fotónál az `entry_id` a bejegyzés, amelyen a napok beírhatók.","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string","enum":["entry","photo"]},"date":{"type":"string","format":"date"},"entry_id":{"type":"string"}}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"delete":{"summary":"Naplóbejegyzés törlése; a hozzá kötött számlálás megmarad, leválasztva. Kezelés törlésekor a kötött számlálások számolt napjai megszűnnek; kezeléshez kötött bejegyzés törlésekor a fotója a kezelés alatt marad. A fotó megörökli a bejegyzés módszerét, és jelölt fotó a beírt napjait is, ha neki nincs.","security":[{"bearer":["write"]}],"responses":{"204":{"description":"Kész, nincs törzs."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/treatments/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) kezelés azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"Kezelés: adatai, a számlálások idővonala és a siker jelzőszáma.","security":[{"bearer":["read"]}],"description":"Az idővonalon a kezeléshez kötött eredmények és az időablakba eső kötetlen természetes hullások vannak, időrendben. A jelzőszám tájékoztató érték: természetes hullás a kezelés kezdete előtt (legfeljebb window_days nappal) és a kezelés vége után (a gyűjtés a vég után kezdődött, legfeljebb window_days nappal). Kezelés alatti, kezelés utáni hullásként (treatment_drop) megadott, jelölés nélküli fotós, más kezelés idejére eső, egy korábbi kezelés vége előtt kezdett és egy újabb kezelés kezdete utáni számlálás látszik, de nem számít.","responses":{"200":{"description":"Kezelés nézet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TreatmentView"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/treatments/{id}/derived-days":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) kezelés azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"Mennyi lenne a számolt nap, ha az adott napon új számlálás kerülne a kezelés alá.","security":[{"bearer":["read"]}],"parameters":[{"name":"date","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"exclude","in":"query","required":false,"description":"A szerkesztett számlálás vagy bejegyzés azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}},{"name":"partner","in":"query","required":false,"description":"Új fotó ehhez a `varroa` bejegyzéshez kötve, jelöltnek véve, ahogy a feltöltést a szerver ellenőrzi.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}},{"name":"method","in":"query","required":false,"description":"A `partner` melletti új fotó módszere.","schema":{"type":"string"}}],"responses":{"200":{"description":"Előnézet.","content":{"application/json":{"schema":{"type":"object","properties":{"days":{"type":["number","null"]},"reason":{"type":["string","null"],"enum":["before_start","same_day","too_long",null]}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/hives/{id}/counts":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) kaptár azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"post":{"summary":"Aljdeszka-fotó feltöltése új számlálásként.","security":[{"bearer":["photos:write"]}],"description":"A beágyazott metaadatokat (EXIF, GPS, XMP stb.) a szerver a képből és az előnézetből is eltávolítja. Az előnézetet (JPEG, legfeljebb 512 KB) és a kép méretét a kliens adja; a fel nem dolgozható előnézet 400 `invalid-thumb`.","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["image","thumb","width","height","taken_on"],"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","description":"JPEG, PNG vagy WebP."},"thumb":{"type":"string","contentMediaType":"image/jpeg"},"width":{"type":"integer","minimum":1,"maximum":50000,"description":"Képszélesség pixelben, EXIF-forgatás után."},"height":{"type":"integer","minimum":1,"maximum":50000},"taken_on":{"type":"string","format":"date"},"notes":{"type":"string","maxLength":2000},"method":{"type":["string","null"],"enum":["","natural_drop","treatment_drop","alcohol_wash","sugar_roll","co2",null],"description":"A számlálás módszere; üres vagy null törli."},"exposure_days":{"type":["number","null"],"minimum":0.5,"maximum":60,"description":"Lépés: 0,5 (más érték 400 invalid-exposure_days). A beírt napok az aljdeszkán (atka/nap számításához). Hullásos módszernél (natural_drop, treatment_drop vagy nincs módszer) kötelező, különben 400 missing-exposure_days, kivéve, ha a számlálás kezeléshez kötött, és a napok kiszámolhatók (effective_days); alcohol_wash, sugar_roll és co2 mellett nem. Régi, napok nélküli számlálás így is módosítható, de a napok nem törölhetők, és napok nélkül nem lehet hullásos módszerre váltani."},"inspection_id":{"type":["string","null"],"pattern":"^[0-9a-f]{32}$","description":"Ugyanannak a kaptárnak átvizsgálás-, atkaszámlálás- vagy kezelés-bejegyzése."}}}}}},"responses":{"201":{"description":"A létrehozott számlálás.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"$ref":"#/components/schemas/CountSummary"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/IdempotencyKeyReused"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/hives/{id}/photo":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) kaptár azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"A kaptárfotó (metaadatok nélkül).","security":[{"bearer":["read"]}],"description":"Cserekor az ETag változik. A kliens a `photo_updated_at` értékét a címbe teheti (`?v=`), mert a válasz egy napig gyorsítótárazható.","responses":{"200":{"description":"Kép.","content":{"image/*":{}}},"304":{"description":"Nem változott."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"summary":"A kaptár saját fotójának feltöltése vagy cseréje.","security":[{"bearer":["photos:write"]}],"description":"A beágyazott metaadatokat (EXIF, GPS, XMP stb.) a szerver a képből és az előnézetből is eltávolítja. A kaptárfotó nem kerül a gépi tanulási adatkészletbe, és nem számlálás: a `count_total` és a `last_*` mezőket nem érinti.","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["image","thumb"],"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","description":"JPEG, PNG vagy WebP."},"thumb":{"type":"string","contentMediaType":"image/jpeg","description":"Előnézet, JPEG, legfeljebb 512 KB."}}}}}},"responses":{"200":{"description":"Mentve.","content":{"application/json":{"schema":{"type":"object","properties":{"photo_updated_at":{"type":"string","format":"date-time"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/TooLarge"},"422":{"$ref":"#/components/responses/IdempotencyKeyReused"},"429":{"$ref":"#/components/responses/RateLimited"}}},"delete":{"summary":"A kaptárfotó törlése.","security":[{"bearer":["write"]}],"description":"Fotó nélküli kaptárnál is 204. A csempe ezután a legutóbbi számlálás előnézetét mutatja.","responses":{"204":{"description":"Kész, nincs törzs."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/hives/{id}/photo/thumb":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) kaptár azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"A kaptárfotó előnézete (JPEG).","security":[{"bearer":["read"]}],"responses":{"200":{"description":"Kép.","content":{"image/jpeg":{}}},"304":{"description":"Nem változott."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/counts/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) számlálás azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"Számlálás a jelölésekkel.","security":[{"bearer":["read"]}],"responses":{"200":{"description":"Számlálás.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"$ref":"#/components/schemas/CountDetail"},"hive":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"name":{"type":"string"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"summary":"Dátum, megjegyzés vagy kaptár módosítása.","security":[{"bearer":["write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"taken_on":{"type":"string","format":"date"},"notes":{"type":"string","maxLength":2000},"hive_id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"method":{"type":["string","null"],"enum":["","natural_drop","treatment_drop","alcohol_wash","sugar_roll","co2",null],"description":"A számlálás módszere; üres vagy null törli."},"exposure_days":{"type":["number","null"],"minimum":0.5,"maximum":60,"description":"Lépés: 0,5 (más érték 400 invalid-exposure_days). A beírt napok az aljdeszkán (atka/nap számításához). Hullásos módszernél (natural_drop, treatment_drop vagy nincs módszer) kötelező, különben 400 missing-exposure_days, kivéve, ha a számlálás kezeléshez kötött, és a napok kiszámolhatók (effective_days); alcohol_wash, sugar_roll és co2 mellett nem. Régi, napok nélküli számlálás így is módosítható, de a napok nem törölhetők, és napok nélkül nem lehet hullásos módszerre váltani."},"inspection_id":{"type":["string","null"],"pattern":"^[0-9a-f]{32}$","description":"Ugyanannak a kaptárnak átvizsgálás-, atkaszámlálás- vagy kezelés-bejegyzése."}}}}}},"responses":{"200":{"description":"A módosított számlálás.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"$ref":"#/components/schemas/CountSummary"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"delete":{"summary":"Számlálás és fotója törlése.","security":[{"bearer":["write"]}],"responses":{"204":{"description":"Kész, nincs törzs."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/counts/{id}/marks":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) számlálás azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"put":{"summary":"A jelölések cseréje.","security":[{"bearer":["write"]}],"description":"A `base` az utoljára látott updated_at; ha azóta máshol módosult, 409 a válasz.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["marks"],"properties":{"marks":{"type":"array","maxItems":20000,"items":{"$ref":"#/components/schemas/Mark"}},"base":{"type":["string","null"],"format":"date-time"}}}}}},"responses":{"200":{"description":"Mentve.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"updated_at":{"type":"string","format":"date-time"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/counts/{id}/image":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) számlálás azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"Az eredeti fotó (metaadatok nélkül).","security":[{"bearer":["read"]}],"responses":{"200":{"description":"Kép.","content":{"image/*":{}}},"304":{"description":"Nem változott."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/counts/{id}/thumb":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) számlálás azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"Előnézet (JPEG).","security":[{"bearer":["read"]}],"responses":{"200":{"description":"Kép.","content":{"image/jpeg":{}}},"304":{"description":"Nem változott."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/counts/{id}/export.json":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) számlálás azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"A jelölések JSON-exportja a képmérettel.","security":[{"bearer":["read"]}],"responses":{"200":{"description":"Export.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/counts/{id}/export.csv":{"parameters":[{"name":"id","in":"path","required":true,"description":"A(z) számlálás azonosítója.","schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"get":{"summary":"A jelölések CSV-exportja.","security":[{"bearer":["read"]}],"responses":{"200":{"description":"CSV (UTF-8, BOM).","content":{"text/csv":{"schema":{"type":"string"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"lh_<id>_<titok>","description":"Személyes API-token a Fiókom oldalról. Jogosultságok: read, write, photos:write."}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":false,"description":"Tetszőleges, kérésenként egyedi kulcs (1–255 látható ASCII-karakter). Ugyanazzal a kulccsal és törzzsel ismételt kérés a tárolt választ kapja (`Idempotent-Replayed: true`) 24 óráig; más törzzsel 422, futó kérés közben 409 (10 perc után a kulcs átvehető). Multipart feltöltésnél a törzset nem hasonlítjuk; más kérés törzse kulccsal legfeljebb 1 MB (413).","schema":{"type":"string","minLength":1,"maxLength":255}}},"responses":{"BadRequest":{"description":"Érvénytelen kérés.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Hiányzó, érvénytelen, lejárt vagy visszavont token (invalid-token, unauthenticated).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Hiányzó jogosultság (insufficient-scope) vagy el nem fogadott felhasználási feltételek (terms-required).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Nincs ilyen (vagy más felhasználóé).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Conflict":{"description":"Ütközés vagy korlát (pl. number-taken, quota, conflict, idempotency-in-progress).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"TooLarge":{"description":"Túl nagy fájl.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"IdempotencyKeyReused":{"description":"Az Idempotency-Key-t már egy másik kéréshez használták.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Túl sok kérés; a Retry-After fejléc mondja meg, mennyit kell várni.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stabil, géppel olvasható kód, pl. not-found, invalid-name."},"message":{"type":"string","description":"Magyar nyelvű üzenet a felhasználónak."}}}}},"ApiaryInput":{"type":"object","properties":{"name":{"type":"string","maxLength":100},"registration":{"type":"string","maxLength":60}}},"Apiary":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"name":{"type":"string"},"registration":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"hive_count":{"type":"integer"}}},"HiveInput":{"type":"object","properties":{"number":{"type":"string","maxLength":20,"description":"Kaptárszám, felhasználónként egyedi (üres is lehet)."},"apiary_id":{"type":["string","null"],"pattern":"^[0-9a-f]{32}$","description":"Saját méhes azonosítója."},"status":{"type":"string","enum":["active","nucleus","merged","dead","sold"]},"established_on":{"type":["string","null"],"format":"date"},"origin":{"type":"string","enum":["","swarm","split","package","bought","other"]},"hive_system":{"type":"string","enum":["","nb","half_nb","hunor","dadant_blatt","langstroth","farrar","zander","dnm","warre","top_bar","layens","other"]},"hive_system_other":{"type":"string","maxLength":60},"frame_size":{"type":"string","maxLength":60},"brood_boxes":{"type":["integer","null"],"minimum":0,"maximum":10},"supers":{"type":["integer","null"],"minimum":0,"maximum":10},"frames_per_box":{"type":["integer","null"],"minimum":1,"maximum":30},"material":{"type":"string","enum":["","wood","polystyrene","other"]},"bottom_board":{"type":"string","enum":["","mesh","solid","other"]},"queen_year":{"type":["integer","null"],"minimum":2000},"queen_marked":{"type":["boolean","null"]},"queen_clipped":{"type":["boolean","null"]},"queen_breed":{"type":"string","maxLength":60},"queen_source":{"type":"string","maxLength":100},"queen_introduced_on":{"type":["string","null"],"format":"date"},"name":{"type":"string","maxLength":100},"notes":{"type":"string","maxLength":2000}}},"Hive":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"name":{"type":"string"},"notes":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"number":{"type":"string","maxLength":20,"description":"Kaptárszám, felhasználónként egyedi (üres is lehet)."},"apiary_id":{"type":["string","null"],"pattern":"^[0-9a-f]{32}$","description":"Saját méhes azonosítója."},"status":{"type":"string","enum":["active","nucleus","merged","dead","sold"]},"established_on":{"type":["string","null"],"format":"date"},"origin":{"type":"string","enum":["","swarm","split","package","bought","other"]},"hive_system":{"type":"string","enum":["","nb","half_nb","hunor","dadant_blatt","langstroth","farrar","zander","dnm","warre","top_bar","layens","other"]},"hive_system_other":{"type":"string","maxLength":60},"frame_size":{"type":"string","maxLength":60},"brood_boxes":{"type":["integer","null"],"minimum":0,"maximum":10},"supers":{"type":["integer","null"],"minimum":0,"maximum":10},"frames_per_box":{"type":["integer","null"],"minimum":1,"maximum":30},"material":{"type":"string","enum":["","wood","polystyrene","other"]},"bottom_board":{"type":"string","enum":["","mesh","solid","other"]},"queen_year":{"type":["integer","null"],"minimum":2000},"queen_marked":{"type":["integer","null"],"enum":[0,1,null],"description":"Válaszban 1/0/null; kérésben true/false/null."},"queen_clipped":{"type":["integer","null"],"enum":[0,1,null],"description":"Válaszban 1/0/null; kérésben true/false/null."},"queen_breed":{"type":"string","maxLength":60},"queen_source":{"type":"string","maxLength":100},"queen_introduced_on":{"type":["string","null"],"format":"date"},"photo_updated_at":{"type":["string","null"],"format":"date-time","description":"A kaptárfotó utolsó feltöltése; null, ha nincs. Írni csak a /hives/{id}/photo végponttal lehet."}}},"HiveListItem":{"allOf":[{"$ref":"#/components/schemas/Hive"},{"type":"object","properties":{"count_total":{"type":"integer"},"last_taken_on":{"type":["string","null"],"format":"date","description":"A legutóbbi fotós számlálás napja. Csak fotó; a fotó nélküli eredményhez lásd latest_result_on."},"last_mark_count":{"type":["integer","null"],"description":"A legutóbbi fotós számlálás atkaszáma. Csak fotó."},"last_count_id":{"type":["string","null"],"description":"A legutóbbi fotós számlálás azonosítója (előnézeti képhez). Csak fotó."},"latest_result_on":{"type":["string","null"],"format":"date","description":"A legutóbbi eredmény napja bármelyik forrásból: fotós számlálás vagy `varroa` naplóbejegyzés `mites` értékkel. Sorrend: dátum, időpont (a fotónak és az időpont nélküli bejegyzésnek nincs, ezek az aznapiak elejére kerülnek), rögzítés ideje; a legkésőbbi nyer. Kivétel: a fotós számláláshoz kötött atkaszámos `varroa` bejegyzés és a fotó egy eredmény. Ha a fotón van jelölés (mark_count > 0), a fotó számít, a dátumoktól függetlenül; ha nincs, a bejegyzés számít, és a fotó nem ad külön eredményt."},"latest_result_mites":{"type":["integer","null"],"minimum":0,"description":"A legutóbbi eredmény atkaszáma bármelyik forrásból."},"latest_result_days":{"type":["number","null"],"description":"A legutóbbi eredmény tényleges napjai (beírt vagy számolt)."},"latest_result_days_source":{"type":["string","null"],"enum":["typed","derived",null],"description":"typed: a felhasználó írta be; derived: a kaptár előző hullásos számlálásától, egy közbeeső kezelés kezdetétől vagy a kezelés kezdetétől számolt."},"latest_result_mites_per_day":{"type":["number","null"],"minimum":0,"description":"A legutóbbi eredmény atka/nap értéke a tényleges napokból; null, ha nincs ilyen, vagy a módszer százalékot ad (mosás, porcukros, CO₂-es)."},"latest_result_source":{"type":["string","null"],"enum":["photo","entry",null],"description":"A legutóbbi eredmény forrása: photo = fotós számlálás, entry = `varroa` naplóbejegyzés."},"latest_result_id":{"type":["string","null"],"description":"A legutóbbi eredmény azonosítója: photo esetén számlálás-, entry esetén naplóbejegyzés-azonosító."},"latest_result_series":{"type":["string","null"],"enum":["natural","treatment","percent",null],"description":"A legutóbbi eredmény sorozata, ugyanazzal a szabállyal, mint az idővonal `series` mezője (natural: természetes hullás; treatment: kezelés utáni hullás, vagy módszer nélkül a kezelés alatt gyűlt; percent: mosás, porcukros, CO₂-es). null, ha nincs eredmény."},"latest_result_in_natural_figures":{"type":["boolean","null"],"description":"Beleszámít-e a legutóbbi eredmény a természetes hullás számaiba, ugyanúgy, mint az idővonal `in_natural_figures` mezője és az összesítő. A kezelés alatt gyűlt natural_drop, a jelölés nélküli fotó, a napok nélküli és a mai (budapesti) nap utáni eredmény nem. null, ha nincs eredmény."},"latest_result_during_treatment":{"type":["boolean","null"],"description":"A legutóbbi eredmény gyűjtése egy kezelés idejére esik (az idővonal `during_treatment` mezője). null, ha nincs eredmény."},"latest_result_unmarked":{"type":["boolean","null"],"description":"A legutóbbi eredmény jelölés nélküli fotó: a 0 nem mérés, nem megszámolt nulla (az idővonalon is_measurement: false). A beírt 0 megszámolt nulla, ott false. null, ha nincs eredmény."},"latest_treatment":{"type":["object","null"],"description":"A legutóbbi, legkésőbb ma (budapesti dátum) kezdett kezelés, ugyanaz, mint az összesítő last_treatment-je; null, ha nincs. A későbbi dátumú (tervezett) kezelés nem ez.","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"date":{"type":"string","format":"date"},"end_date":{"type":["string","null"],"format":"date","description":"A megadott vége; null, ha nincs megadva."},"product":{"type":["string","null"],"description":"A készítmény; null, ha nincs megadva."},"assumed_end":{"type":"string","format":"date","description":"A statisztika által feltételezett vége: az end_date, ennek híján a kezdet + 30 nap. Feltételezés, nem annak bizonyítéka, hogy a hordozó még bent van."},"ongoing":{"type":"boolean","description":"A kezelés időszaka (kezdet – assumed_end) lefedi a mai budapesti napot. Ugyanaz a szabály, mint a get_hive MCP-eszköz latest_treatment.ongoing mezője."}}},"map_x":{"type":["integer","null"],"minimum":0,"maximum":9,"description":"Méhestérkép: oszlop; null = nincs elhelyezve (új kaptárnál és másik méhesbe kerülve is). A GET /hives listában és a POST /hives válaszában."},"map_y":{"type":["integer","null"],"minimum":0,"maximum":49,"description":"Méhestérkép: sor; null = nincs elhelyezve."},"map_rot":{"type":"integer","enum":[0,90,180,270],"description":"A kijárat iránya fokban (0 = lefelé)."}}}]},"CountSummary":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"hive_id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"taken_on":{"type":"string","format":"date"},"notes":{"type":"string"},"filename":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"mark_count":{"type":"integer"},"method":{"type":"string","enum":["","natural_drop","treatment_drop","alcohol_wash","sugar_roll","co2"],"description":"A számlálás módszere (üres: nincs megadva)."},"exposure_days":{"type":["number","null"],"minimum":0.5,"maximum":60,"description":"Lépés: 0,5 (más érték 400 invalid-exposure_days). A beírt napok az aljdeszkán (atka/nap számításához). Hullásos módszernél (natural_drop, treatment_drop vagy nincs módszer) kötelező, különben 400 missing-exposure_days, kivéve, ha a számlálás kezeléshez kötött, és a napok kiszámolhatók (effective_days); alcohol_wash, sugar_roll és co2 mellett nem. Régi, napok nélküli számlálás így is módosítható, de a napok nem törölhetők, és napok nélkül nem lehet hullásos módszerre váltani."},"inspection_id":{"type":["string","null"],"pattern":"^[0-9a-f]{32}$","description":"Ugyanannak a kaptárnak átvizsgálás-, atkaszámlálás- vagy kezelés-bejegyzése."},"effective_days":{"type":["number","null"],"description":"A tényleges napok: a beírt érték, különben a számolt (a kaptár előző hullásos számlálása, egy közbeeső kezelés kezdete, vagy a kezelés kezdete óta). Null, ha egyik sincs: nem kötött számlálás, a kezdet előtti vagy azon a napon készült számlálás, aznapi második számlálás, 60 napnál hosszabb idő, mosás, porcukros és CO₂-es módszer. Olvasáskor számolódik, nem tárolt."},"days_source":{"type":["string","null"],"enum":["typed","derived",null],"description":"typed: a felhasználó írta be; derived: a kaptár előző hullásos számlálásától, egy közbeeső kezelés kezdetétől vagy a kezelés kezdetétől számolt."},"mites_per_day":{"type":["number","null"],"description":"Atka/nap a tényleges napokból; százalékot adó módszernél és napok nélkül null."},"treatment_id":{"type":["string","null"],"pattern":"^[0-9a-f]{32}$","description":"A kezelés, amely alá a számlálás tartozik: közvetlenül (inspection_id) vagy a `varroa` bejegyzésén át."},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"EntryInput":{"type":"object","properties":{"kind":{"type":"string","enum":["inspection","varroa","treatment","feeding","harvest","queen","colony","weight"],"description":"Létrehozás után nem módosítható."},"date":{"type":"string","format":"date","description":"Kezelésnél a kezelés kezdete."},"time":{"type":["string","null"],"pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"notes":{"type":"string","maxLength":2000,"description":"A hosszabbat a szerver levágja."},"todo":{"type":"string","maxLength":500,"description":"Legközelebb teendő. A hosszabbat a szerver levágja."},"update_profile":{"type":"boolean","description":"Csak létrehozáskor: anya- és családesemény átvezetése az adatlapra."},"data":{"type":"object","properties":{"duration_min":{"description":"Időtartam. Fajta: inspection. A null törli.","anyOf":[{"type":"integer","minimum":0,"maximum":600},{"type":"null"}]},"temperature_c":{"description":"Hőmérséklet. Fajta: inspection. A null törli.","anyOf":[{"type":"integer","minimum":-30,"maximum":50},{"type":"null"}]},"weather":{"description":"Időjárás. Fajta: inspection. A null törli.","anyOf":[{"type":"string","enum":["sunny","partly_cloudy","cloudy","windy","rain"]},{"type":"null"}]},"queen_seen":{"description":"Anyát láttam. Fajta: inspection. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"eggs_seen":{"description":"Petét láttam. Fajta: inspection. A pete a petéző anya legbiztosabb jele. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"queen_cells":{"description":"Anyabölcső. Fajta: inspection. Nincs: egyáltalán nincs bölcső. Ha csak kikelt vagy oldalt kibontott bölcsőt láttál, hagyd üresen. A null törli.","anyOf":[{"type":"string","enum":["none","cups","swarm","supersedure","emergency"]},{"type":"null"}]},"queen_cell_state":{"description":"Anyabölcsők állapota. Fajta: inspection. Minden látott állapot (pl. fedett és kikelt is); ha mind kikelt, csak a kikelt. Kikelt: a csúcsán kerek nyílás, gyakran visszahajló kupakkal. Oldalt kibontott: az oldalán szabálytalan lyuk; a méhész törlése az elvégzett munkák között van. A null törli.","anyOf":[{"type":"array","items":{"type":"string","enum":["open","sealed","hatched","destroyed"]},"uniqueItems":true},{"type":"null"}]},"bee_frames":{"description":"Méhekkel fedett keretek (utcák). Fajta: inspection. Hány keretet (utcát) fednek a méhek, a kaptár összes fiókjában együtt. Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":60},{"type":"null"}]},"brood_frames":{"description":"Fiasításos keretek. Fajta: inspection. Hány kereten van fiasítás (bármilyen: pete, nyitott, fedett, bármennyi), a kaptár összes fiókjában együtt. Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":60},{"type":"null"}]},"brood_pattern":{"description":"Fiasítás zártsága (1 hézagos – 5 zárt). Fajta: inspection. A null törli.","anyOf":[{"type":"integer","minimum":1,"maximum":5},{"type":"null"}]},"open_brood":{"description":"Nyitott fiasítás. Fajta: inspection. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"sealed_brood":{"description":"Fedett fiasítás. Fajta: inspection. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"drone_brood":{"description":"Herefiasítás. Fajta: inspection. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"honey_frames":{"description":"Mézes keretek. Fajta: inspection. Teli keretnyi mennyiségben: teli keret 1, félig teli keret 0,5, mézkoszorú kb. 0,25, kevés 0. A kaptár összes fiókjában együtt, fél keretre kerekítve (a negyed felfelé). Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":60},{"type":"null"}]},"pollen_frames":{"description":"Virágporos keretek. Fajta: inspection. Teli keretnyi mennyiségben: teli keret 1, félig teli keret 0,5, koszorú kb. 0,25, kevés 0. A kaptár összes fiókjában együtt, fél keretre kerekítve (a negyed felfelé). Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":60},{"type":"null"}]},"needs_feeding":{"description":"Etetni kell. Fajta: inspection. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"temperament":{"description":"Viselkedés (1 szelíd – 5 támadó). Fajta: inspection. A null törli.","anyOf":[{"type":"integer","minimum":1,"maximum":5},{"type":"null"}]},"on_frames":{"description":"A kereteken. Fajta: inspection. A null törli.","anyOf":[{"type":"string","enum":["calm","nervous","running"]},{"type":"null"}]},"swarm_signs":{"description":"Rajzási hangulat. Fajta: inspection. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"actions":{"description":"Elvégzett munkák. Fajta: inspection. A null törli.","anyOf":[{"type":"array","items":{"type":"string","enum":["super_added","super_removed","brood_box_added","foundation_added","frames_moved","brood_removed","split_made","queen_cells_removed","excluder","entrance_reduced"]},"uniqueItems":true},{"type":"null"}]},"health_signs":{"description":"Betegség, kártevő. Fajta: inspection. A költésrothadás és a kis kaptárbogár gyanúját a hatósági állatorvosnak be kell jelenteni. A null törli.","anyOf":[{"type":"array","items":{"type":"string","enum":["chalkbrood","sacbrood","foulbrood_suspect","dwv","nosema","wax_moth","small_hive_beetle","wasps","robbing","varroa_visible","other"]},"uniqueItems":true},{"type":"null"}]},"method":{"description":"Módszer. Fajta: varroa. A null törli.","anyOf":[{"type":"string","enum":["natural_drop","treatment_drop","alcohol_wash","sugar_roll","co2"]},{"type":"null"}]},"mites":{"description":"Atkák száma. Fajta: varroa. A null törli.","anyOf":[{"type":"integer","minimum":0,"maximum":100000},{"type":"null"}]},"exposure_days":{"description":"Napok az aljdeszkán. Fajta: varroa. Hullásnál kötelező, ha atkaszámot írsz be: hány napig gyűlt az aljdeszkán. Ebből lesz az atka/nap. Kezeléshez kötött számlálásnál elhagyható, ha kiszámolható. Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400. A null törli, de atkaszámos hullásos bejegyzésnél (natural_drop, treatment_drop vagy nincs módszer) 400 missing-exposure_days a válasz, amíg az atkaszám megmarad, kivéve, ha a bejegyzés kezeléshez kötött, és a napok kiszámolhatók (lásd derived.effective_days). Alcohol_wash, sugar_roll és co2 mellett nem kötelező.","anyOf":[{"type":"number","minimum":0.5,"maximum":60},{"type":"null"}]},"treatment_id":{"description":"Kezelés. Fajta: varroa. A kaptár kezelése, amelyhez ez a számlálás tartozik. Ugyanannak a kaptárnak `treatment` bejegyzése; más kaptáré vagy más felhasználóé 404. A kezelés törlése a kötést törli, a számlálást megtartja. A null törli.","anyOf":[{"type":"string","pattern":"^[0-9a-f]{32}$"},{"type":"null"}]},"sample_bees":{"description":"Minta (méh). Fajta: varroa. Mosásnál, porcukros módszernél: kb. 300 méh ≈ fél dl. A null törli.","anyOf":[{"type":"integer","minimum":1,"maximum":2000},{"type":"null"}]},"product":{"description":"Készítmény. Fajta: treatment. A null törli.","anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"active_ingredient":{"description":"Hatóanyag. Fajta: treatment. A null törli.","anyOf":[{"type":"string","enum":["oxalic_acid","formic_acid","lactic_acid","amitraz","thymol","tau_fluvalinate","flumethrin","other"]},{"type":"null"}]},"treatment_method":{"description":"Alkalmazás módja. Fajta: treatment. A null törli.","anyOf":[{"type":"string","enum":["trickle","sublimation","spray","fumigation","strip","evaporator","other"]},{"type":"null"}]},"dose":{"description":"Mennyiség. Fajta: treatment. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":10000},{"type":"null"}]},"dose_unit":{"description":"Egység. Fajta: treatment. A null törli.","anyOf":[{"type":"string","enum":["ml","g","strip","pad","tablet","other"]},{"type":"null"}]},"end_date":{"description":"Kezelés vége. Fajta: treatment. Egynapos kezelésnél a kezdő nap. Enélkül nem számolható, mennyit változott a hullás a kezelés után. A null törli.","anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"batch":{"description":"Gyártási tétel (sarzs). Fajta: treatment. A null törli.","anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"withdrawal_days":{"description":"Élelmezés-egészségügyi várakozási idő. Fajta: treatment. A nulla napot is be kell írni. A null törli.","anyOf":[{"type":"integer","minimum":0,"maximum":365},{"type":"null"}]},"supplier":{"description":"Beszerzés helye (forgalmazó neve, címe). Fajta: treatment. A null törli.","anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"purchase_ref":{"description":"Számla / bizonylat száma. Fajta: treatment. A null törli.","anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"vet":{"description":"Állatorvos (ha rendelte). Fajta: treatment. A null törli.","anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"prescription_number":{"description":"Recept száma. Fajta: treatment. Az állatorvosi recept száma, ha van. A null törli.","anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"feed_type":{"description":"Takarmány. Fajta: feeding. A null törli.","anyOf":[{"type":"string","enum":["syrup_1_1","syrup_3_2","syrup_2_1","invert_syrup","fondant","pollen_patty","honey","other"]},{"type":"null"}]},"amount":{"description":"Mennyiség. Fajta: feeding. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":1000},{"type":"null"}]},"amount_unit":{"description":"Egység. Fajta: feeding. A null törli.","anyOf":[{"type":"string","enum":["kg","l"]},{"type":"null"}]},"honey_kg":{"description":"Méz. Fajta: harvest. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":1000},{"type":"null"}]},"honey_type":{"description":"Méz fajtája. Fajta: harvest. A null törli.","anyOf":[{"type":"string","enum":["acacia","rapeseed","sunflower","linden","milkweed","phacelia","chestnut","lavender","goldenrod","honeydew","mixed","other"]},{"type":"null"}]},"supers_taken":{"description":"Elvett mézkamrák. Fajta: harvest. A null törli.","anyOf":[{"type":"integer","minimum":0,"maximum":20},{"type":"null"}]},"frames_taken":{"description":"Elvett keretek. Fajta: harvest. A null törli.","anyOf":[{"type":"integer","minimum":0,"maximum":200},{"type":"null"}]},"queen_event":{"description":"Esemény. Fajta: queen. A null törli.","anyOf":[{"type":"string","enum":["introduced","replaced","superseded","lost","marked","clipped"]},{"type":"null"}]},"queen_year":{"description":"Az új anya születési éve. Fajta: queen. A null törli.","anyOf":[{"type":"integer","minimum":2000,"maximum":2100},{"type":"null"}]},"queen_breed":{"description":"Fajta. Fajta: queen. A null törli.","anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"queen_source":{"description":"Származás. Fajta: queen. A null törli.","anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"colony_event":{"description":"Esemény. Fajta: colony. A null törli.","anyOf":[{"type":"string","enum":["split","merged","swarmed","moved","overwintered","died"]},{"type":"null"}]},"apiary_id":{"description":"Új méhes. Fajta: colony. Saját méhes azonosítója. A null törli.","anyOf":[{"type":"string","pattern":"^[0-9a-f]{32}$"},{"type":"null"}]},"death_cause":{"description":"Pusztulás oka. Fajta: colony. A null törli.","anyOf":[{"type":"string","enum":["varroa","starvation","queenless","robbing","poisoning","cold","unknown","other"]},{"type":"null"}]},"weight_kg":{"description":"Tömeg. Fajta: weight, inspection. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":300},{"type":"null"}]},"weight_source":{"description":"Mérés módja. Fajta: weight, inspection. A null törli.","anyOf":[{"type":"string","enum":["scale","manual","hefting"]},{"type":"null"}]}}},"duration_min":{"description":"Időtartam. Fajta: inspection. A null törli.","anyOf":[{"type":"integer","minimum":0,"maximum":600},{"type":"null"}]},"temperature_c":{"description":"Hőmérséklet. Fajta: inspection. A null törli.","anyOf":[{"type":"integer","minimum":-30,"maximum":50},{"type":"null"}]},"weather":{"description":"Időjárás. Fajta: inspection. A null törli.","anyOf":[{"type":"string","enum":["sunny","partly_cloudy","cloudy","windy","rain"]},{"type":"null"}]},"queen_seen":{"description":"Anyát láttam. Fajta: inspection. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"eggs_seen":{"description":"Petét láttam. Fajta: inspection. A pete a petéző anya legbiztosabb jele. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"queen_cells":{"description":"Anyabölcső. Fajta: inspection. Nincs: egyáltalán nincs bölcső. Ha csak kikelt vagy oldalt kibontott bölcsőt láttál, hagyd üresen. A null törli.","anyOf":[{"type":"string","enum":["none","cups","swarm","supersedure","emergency"]},{"type":"null"}]},"queen_cell_state":{"description":"Anyabölcsők állapota. Fajta: inspection. Minden látott állapot (pl. fedett és kikelt is); ha mind kikelt, csak a kikelt. Kikelt: a csúcsán kerek nyílás, gyakran visszahajló kupakkal. Oldalt kibontott: az oldalán szabálytalan lyuk; a méhész törlése az elvégzett munkák között van. A null törli.","anyOf":[{"type":"array","items":{"type":"string","enum":["open","sealed","hatched","destroyed"]},"uniqueItems":true},{"type":"null"}]},"bee_frames":{"description":"Méhekkel fedett keretek (utcák). Fajta: inspection. Hány keretet (utcát) fednek a méhek, a kaptár összes fiókjában együtt. Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":60},{"type":"null"}]},"brood_frames":{"description":"Fiasításos keretek. Fajta: inspection. Hány kereten van fiasítás (bármilyen: pete, nyitott, fedett, bármennyi), a kaptár összes fiókjában együtt. Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":60},{"type":"null"}]},"brood_pattern":{"description":"Fiasítás zártsága (1 hézagos – 5 zárt). Fajta: inspection. A null törli.","anyOf":[{"type":"integer","minimum":1,"maximum":5},{"type":"null"}]},"open_brood":{"description":"Nyitott fiasítás. Fajta: inspection. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"sealed_brood":{"description":"Fedett fiasítás. Fajta: inspection. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"drone_brood":{"description":"Herefiasítás. Fajta: inspection. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"honey_frames":{"description":"Mézes keretek. Fajta: inspection. Teli keretnyi mennyiségben: teli keret 1, félig teli keret 0,5, mézkoszorú kb. 0,25, kevés 0. A kaptár összes fiókjában együtt, fél keretre kerekítve (a negyed felfelé). Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":60},{"type":"null"}]},"pollen_frames":{"description":"Virágporos keretek. Fajta: inspection. Teli keretnyi mennyiségben: teli keret 1, félig teli keret 0,5, koszorú kb. 0,25, kevés 0. A kaptár összes fiókjában együtt, fél keretre kerekítve (a negyed felfelé). Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":60},{"type":"null"}]},"needs_feeding":{"description":"Etetni kell. Fajta: inspection. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"temperament":{"description":"Viselkedés (1 szelíd – 5 támadó). Fajta: inspection. A null törli.","anyOf":[{"type":"integer","minimum":1,"maximum":5},{"type":"null"}]},"on_frames":{"description":"A kereteken. Fajta: inspection. A null törli.","anyOf":[{"type":"string","enum":["calm","nervous","running"]},{"type":"null"}]},"swarm_signs":{"description":"Rajzási hangulat. Fajta: inspection. A null törli.","anyOf":[{"type":"boolean"},{"type":"null"}]},"actions":{"description":"Elvégzett munkák. Fajta: inspection. A null törli.","anyOf":[{"type":"array","items":{"type":"string","enum":["super_added","super_removed","brood_box_added","foundation_added","frames_moved","brood_removed","split_made","queen_cells_removed","excluder","entrance_reduced"]},"uniqueItems":true},{"type":"null"}]},"health_signs":{"description":"Betegség, kártevő. Fajta: inspection. A költésrothadás és a kis kaptárbogár gyanúját a hatósági állatorvosnak be kell jelenteni. A null törli.","anyOf":[{"type":"array","items":{"type":"string","enum":["chalkbrood","sacbrood","foulbrood_suspect","dwv","nosema","wax_moth","small_hive_beetle","wasps","robbing","varroa_visible","other"]},"uniqueItems":true},{"type":"null"}]},"method":{"description":"Módszer. Fajta: varroa. A null törli.","anyOf":[{"type":"string","enum":["natural_drop","treatment_drop","alcohol_wash","sugar_roll","co2"]},{"type":"null"}]},"mites":{"description":"Atkák száma. Fajta: varroa. A null törli.","anyOf":[{"type":"integer","minimum":0,"maximum":100000},{"type":"null"}]},"exposure_days":{"description":"Napok az aljdeszkán. Fajta: varroa. Hullásnál kötelező, ha atkaszámot írsz be: hány napig gyűlt az aljdeszkán. Ebből lesz az atka/nap. Kezeléshez kötött számlálásnál elhagyható, ha kiszámolható. Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400. A null törli, de atkaszámos hullásos bejegyzésnél (natural_drop, treatment_drop vagy nincs módszer) 400 missing-exposure_days a válasz, amíg az atkaszám megmarad, kivéve, ha a bejegyzés kezeléshez kötött, és a napok kiszámolhatók (lásd derived.effective_days). Alcohol_wash, sugar_roll és co2 mellett nem kötelező.","anyOf":[{"type":"number","minimum":0.5,"maximum":60},{"type":"null"}]},"treatment_id":{"description":"Kezelés. Fajta: varroa. A kaptár kezelése, amelyhez ez a számlálás tartozik. Ugyanannak a kaptárnak `treatment` bejegyzése; más kaptáré vagy más felhasználóé 404. A kezelés törlése a kötést törli, a számlálást megtartja. A null törli.","anyOf":[{"type":"string","pattern":"^[0-9a-f]{32}$"},{"type":"null"}]},"sample_bees":{"description":"Minta (méh). Fajta: varroa. Mosásnál, porcukros módszernél: kb. 300 méh ≈ fél dl. A null törli.","anyOf":[{"type":"integer","minimum":1,"maximum":2000},{"type":"null"}]},"product":{"description":"Készítmény. Fajta: treatment. A null törli.","anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"active_ingredient":{"description":"Hatóanyag. Fajta: treatment. A null törli.","anyOf":[{"type":"string","enum":["oxalic_acid","formic_acid","lactic_acid","amitraz","thymol","tau_fluvalinate","flumethrin","other"]},{"type":"null"}]},"treatment_method":{"description":"Alkalmazás módja. Fajta: treatment. A null törli.","anyOf":[{"type":"string","enum":["trickle","sublimation","spray","fumigation","strip","evaporator","other"]},{"type":"null"}]},"dose":{"description":"Mennyiség. Fajta: treatment. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":10000},{"type":"null"}]},"dose_unit":{"description":"Egység. Fajta: treatment. A null törli.","anyOf":[{"type":"string","enum":["ml","g","strip","pad","tablet","other"]},{"type":"null"}]},"end_date":{"description":"Kezelés vége. Fajta: treatment. Egynapos kezelésnél a kezdő nap. Enélkül nem számolható, mennyit változott a hullás a kezelés után. A null törli.","anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"batch":{"description":"Gyártási tétel (sarzs). Fajta: treatment. A null törli.","anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"withdrawal_days":{"description":"Élelmezés-egészségügyi várakozási idő. Fajta: treatment. A nulla napot is be kell írni. A null törli.","anyOf":[{"type":"integer","minimum":0,"maximum":365},{"type":"null"}]},"supplier":{"description":"Beszerzés helye (forgalmazó neve, címe). Fajta: treatment. A null törli.","anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"purchase_ref":{"description":"Számla / bizonylat száma. Fajta: treatment. A null törli.","anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"vet":{"description":"Állatorvos (ha rendelte). Fajta: treatment. A null törli.","anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"prescription_number":{"description":"Recept száma. Fajta: treatment. Az állatorvosi recept száma, ha van. A null törli.","anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"feed_type":{"description":"Takarmány. Fajta: feeding. A null törli.","anyOf":[{"type":"string","enum":["syrup_1_1","syrup_3_2","syrup_2_1","invert_syrup","fondant","pollen_patty","honey","other"]},{"type":"null"}]},"amount":{"description":"Mennyiség. Fajta: feeding. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":1000},{"type":"null"}]},"amount_unit":{"description":"Egység. Fajta: feeding. A null törli.","anyOf":[{"type":"string","enum":["kg","l"]},{"type":"null"}]},"honey_kg":{"description":"Méz. Fajta: harvest. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":1000},{"type":"null"}]},"honey_type":{"description":"Méz fajtája. Fajta: harvest. A null törli.","anyOf":[{"type":"string","enum":["acacia","rapeseed","sunflower","linden","milkweed","phacelia","chestnut","lavender","goldenrod","honeydew","mixed","other"]},{"type":"null"}]},"supers_taken":{"description":"Elvett mézkamrák. Fajta: harvest. A null törli.","anyOf":[{"type":"integer","minimum":0,"maximum":20},{"type":"null"}]},"frames_taken":{"description":"Elvett keretek. Fajta: harvest. A null törli.","anyOf":[{"type":"integer","minimum":0,"maximum":200},{"type":"null"}]},"queen_event":{"description":"Esemény. Fajta: queen. A null törli.","anyOf":[{"type":"string","enum":["introduced","replaced","superseded","lost","marked","clipped"]},{"type":"null"}]},"queen_year":{"description":"Az új anya születési éve. Fajta: queen. A null törli.","anyOf":[{"type":"integer","minimum":2000,"maximum":2100},{"type":"null"}]},"queen_breed":{"description":"Fajta. Fajta: queen. A null törli.","anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"queen_source":{"description":"Származás. Fajta: queen. A null törli.","anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"colony_event":{"description":"Esemény. Fajta: colony. A null törli.","anyOf":[{"type":"string","enum":["split","merged","swarmed","moved","overwintered","died"]},{"type":"null"}]},"apiary_id":{"description":"Új méhes. Fajta: colony. Saját méhes azonosítója. A null törli.","anyOf":[{"type":"string","pattern":"^[0-9a-f]{32}$"},{"type":"null"}]},"death_cause":{"description":"Pusztulás oka. Fajta: colony. A null törli.","anyOf":[{"type":"string","enum":["varroa","starvation","queenless","robbing","poisoning","cold","unknown","other"]},{"type":"null"}]},"weight_kg":{"description":"Tömeg. Fajta: weight, inspection. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400. A null törli.","anyOf":[{"type":"number","minimum":0,"maximum":300},{"type":"null"}]},"weight_source":{"description":"Mérés módja. Fajta: weight, inspection. A null törli.","anyOf":[{"type":"string","enum":["scale","manual","hefting"]},{"type":"null"}]}}},"Entry":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"hive_id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"kind":{"type":"string","enum":["inspection","varroa","treatment","feeding","harvest","queen","colony","weight"]},"date":{"type":"string","format":"date"},"time":{"type":["string","null"]},"notes":{"type":"string"},"todo":{"type":"string"},"data":{"type":"object","properties":{"duration_min":{"type":"integer","minimum":0,"maximum":600,"description":"Időtartam. Fajta: inspection."},"temperature_c":{"type":"integer","minimum":-30,"maximum":50,"description":"Hőmérséklet. Fajta: inspection."},"weather":{"type":"string","enum":["sunny","partly_cloudy","cloudy","windy","rain"],"description":"Időjárás. Fajta: inspection."},"queen_seen":{"type":"boolean","description":"Anyát láttam. Fajta: inspection."},"eggs_seen":{"type":"boolean","description":"Petét láttam. Fajta: inspection. A pete a petéző anya legbiztosabb jele."},"queen_cells":{"type":"string","enum":["none","cups","swarm","supersedure","emergency"],"description":"Anyabölcső. Fajta: inspection. Nincs: egyáltalán nincs bölcső. Ha csak kikelt vagy oldalt kibontott bölcsőt láttál, hagyd üresen."},"queen_cell_state":{"type":"array","items":{"type":"string","enum":["open","sealed","hatched","destroyed"]},"uniqueItems":true,"description":"Anyabölcsők állapota. Fajta: inspection. Minden látott állapot (pl. fedett és kikelt is); ha mind kikelt, csak a kikelt. Kikelt: a csúcsán kerek nyílás, gyakran visszahajló kupakkal. Oldalt kibontott: az oldalán szabálytalan lyuk; a méhész törlése az elvégzett munkák között van."},"bee_frames":{"type":"number","minimum":0,"maximum":60,"description":"Méhekkel fedett keretek (utcák). Fajta: inspection. Hány keretet (utcát) fednek a méhek, a kaptár összes fiókjában együtt. Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400."},"brood_frames":{"type":"number","minimum":0,"maximum":60,"description":"Fiasításos keretek. Fajta: inspection. Hány kereten van fiasítás (bármilyen: pete, nyitott, fedett, bármennyi), a kaptár összes fiókjában együtt. Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400."},"brood_pattern":{"type":"integer","minimum":1,"maximum":5,"description":"Fiasítás zártsága (1 hézagos – 5 zárt). Fajta: inspection."},"open_brood":{"type":"boolean","description":"Nyitott fiasítás. Fajta: inspection."},"sealed_brood":{"type":"boolean","description":"Fedett fiasítás. Fajta: inspection."},"drone_brood":{"type":"boolean","description":"Herefiasítás. Fajta: inspection."},"honey_frames":{"type":"number","minimum":0,"maximum":60,"description":"Mézes keretek. Fajta: inspection. Teli keretnyi mennyiségben: teli keret 1, félig teli keret 0,5, mézkoszorú kb. 0,25, kevés 0. A kaptár összes fiókjában együtt, fél keretre kerekítve (a negyed felfelé). Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400."},"pollen_frames":{"type":"number","minimum":0,"maximum":60,"description":"Virágporos keretek. Fajta: inspection. Teli keretnyi mennyiségben: teli keret 1, félig teli keret 0,5, koszorú kb. 0,25, kevés 0. A kaptár összes fiókjában együtt, fél keretre kerekítve (a negyed felfelé). Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400."},"needs_feeding":{"type":"boolean","description":"Etetni kell. Fajta: inspection."},"temperament":{"type":"integer","minimum":1,"maximum":5,"description":"Viselkedés (1 szelíd – 5 támadó). Fajta: inspection."},"on_frames":{"type":"string","enum":["calm","nervous","running"],"description":"A kereteken. Fajta: inspection."},"swarm_signs":{"type":"boolean","description":"Rajzási hangulat. Fajta: inspection."},"actions":{"type":"array","items":{"type":"string","enum":["super_added","super_removed","brood_box_added","foundation_added","frames_moved","brood_removed","split_made","queen_cells_removed","excluder","entrance_reduced"]},"uniqueItems":true,"description":"Elvégzett munkák. Fajta: inspection."},"health_signs":{"type":"array","items":{"type":"string","enum":["chalkbrood","sacbrood","foulbrood_suspect","dwv","nosema","wax_moth","small_hive_beetle","wasps","robbing","varroa_visible","other"]},"uniqueItems":true,"description":"Betegség, kártevő. Fajta: inspection. A költésrothadás és a kis kaptárbogár gyanúját a hatósági állatorvosnak be kell jelenteni."},"method":{"type":"string","enum":["natural_drop","treatment_drop","alcohol_wash","sugar_roll","co2"],"description":"Módszer. Fajta: varroa."},"mites":{"type":"integer","minimum":0,"maximum":100000,"description":"Atkák száma. Fajta: varroa."},"exposure_days":{"type":"number","minimum":0.5,"maximum":60,"description":"Napok az aljdeszkán. Fajta: varroa. Hullásnál kötelező, ha atkaszámot írsz be: hány napig gyűlt az aljdeszkán. Ebből lesz az atka/nap. Kezeléshez kötött számlálásnál elhagyható, ha kiszámolható. Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400."},"treatment_id":{"type":"string","pattern":"^[0-9a-f]{32}$","description":"Kezelés. Fajta: varroa. A kaptár kezelése, amelyhez ez a számlálás tartozik. Ugyanannak a kaptárnak `treatment` bejegyzése; más kaptáré vagy más felhasználóé 404. A kezelés törlése a kötést törli, a számlálást megtartja."},"sample_bees":{"type":"integer","minimum":1,"maximum":2000,"description":"Minta (méh). Fajta: varroa. Mosásnál, porcukros módszernél: kb. 300 méh ≈ fél dl."},"product":{"type":"string","maxLength":100,"description":"Készítmény. Fajta: treatment."},"active_ingredient":{"type":"string","enum":["oxalic_acid","formic_acid","lactic_acid","amitraz","thymol","tau_fluvalinate","flumethrin","other"],"description":"Hatóanyag. Fajta: treatment."},"treatment_method":{"type":"string","enum":["trickle","sublimation","spray","fumigation","strip","evaporator","other"],"description":"Alkalmazás módja. Fajta: treatment."},"dose":{"type":"number","minimum":0,"maximum":10000,"description":"Mennyiség. Fajta: treatment. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400."},"dose_unit":{"type":"string","enum":["ml","g","strip","pad","tablet","other"],"description":"Egység. Fajta: treatment."},"end_date":{"type":"string","format":"date","description":"Kezelés vége. Fajta: treatment. Egynapos kezelésnél a kezdő nap. Enélkül nem számolható, mennyit változott a hullás a kezelés után."},"batch":{"type":"string","maxLength":60,"description":"Gyártási tétel (sarzs). Fajta: treatment."},"withdrawal_days":{"type":"integer","minimum":0,"maximum":365,"description":"Élelmezés-egészségügyi várakozási idő. Fajta: treatment. A nulla napot is be kell írni."},"supplier":{"type":"string","maxLength":200,"description":"Beszerzés helye (forgalmazó neve, címe). Fajta: treatment."},"purchase_ref":{"type":"string","maxLength":60,"description":"Számla / bizonylat száma. Fajta: treatment."},"vet":{"type":"string","maxLength":200,"description":"Állatorvos (ha rendelte). Fajta: treatment."},"prescription_number":{"type":"string","maxLength":60,"description":"Recept száma. Fajta: treatment. Az állatorvosi recept száma, ha van."},"feed_type":{"type":"string","enum":["syrup_1_1","syrup_3_2","syrup_2_1","invert_syrup","fondant","pollen_patty","honey","other"],"description":"Takarmány. Fajta: feeding."},"amount":{"type":"number","minimum":0,"maximum":1000,"description":"Mennyiség. Fajta: feeding. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400."},"amount_unit":{"type":"string","enum":["kg","l"],"description":"Egység. Fajta: feeding."},"honey_kg":{"type":"number","minimum":0,"maximum":1000,"description":"Méz. Fajta: harvest. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400."},"honey_type":{"type":"string","enum":["acacia","rapeseed","sunflower","linden","milkweed","phacelia","chestnut","lavender","goldenrod","honeydew","mixed","other"],"description":"Méz fajtája. Fajta: harvest."},"supers_taken":{"type":"integer","minimum":0,"maximum":20,"description":"Elvett mézkamrák. Fajta: harvest."},"frames_taken":{"type":"integer","minimum":0,"maximum":200,"description":"Elvett keretek. Fajta: harvest."},"queen_event":{"type":"string","enum":["introduced","replaced","superseded","lost","marked","clipped"],"description":"Esemény. Fajta: queen."},"queen_year":{"type":"integer","minimum":2000,"maximum":2100,"description":"Az új anya születési éve. Fajta: queen."},"queen_breed":{"type":"string","maxLength":60,"description":"Fajta. Fajta: queen."},"queen_source":{"type":"string","maxLength":100,"description":"Származás. Fajta: queen."},"colony_event":{"type":"string","enum":["split","merged","swarmed","moved","overwintered","died"],"description":"Esemény. Fajta: colony."},"apiary_id":{"type":"string","pattern":"^[0-9a-f]{32}$","description":"Új méhes. Fajta: colony. Saját méhes azonosítója."},"death_cause":{"type":"string","enum":["varroa","starvation","queenless","robbing","poisoning","cold","unknown","other"],"description":"Pusztulás oka. Fajta: colony."},"weight_kg":{"type":"number","minimum":0,"maximum":300,"description":"Tömeg. Fajta: weight, inspection. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400."},"weight_source":{"type":"string","enum":["scale","manual","hefting"],"description":"Mérés módja. Fajta: weight, inspection."}}},"derived":{"type":"object","description":"Számított értékek (csak olvasható).","properties":{"mites_per_day":{"type":"number","description":"A tényleges napokból."},"infestation_pct":{"type":"number"},"effective_days":{"type":"number","description":"A tényleges napok: a beírt érték, különben a számolt (a kaptár előző hullásos számlálása, egy közbeeső kezelés kezdete, vagy a kezelés kezdete óta). Null, ha egyik sincs: nem kötött számlálás, a kezdet előtti vagy azon a napon készült számlálás, aznapi második számlálás, 60 napnál hosszabb idő, mosás, porcukros és CO₂-es módszer. Olvasáskor számolódik, nem tárolt."},"days_source":{"type":"string","enum":["typed","derived"]}}},"count_ids":{"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{32}$"},"description":"A bejegyzéshez kötött fotós számlálások."},"schema_version":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"TreatmentView":{"type":"object","properties":{"treatment":{"$ref":"#/components/schemas/Entry"},"hive":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"name":{"type":"string"},"number":{"type":"string"}}},"timeline":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","enum":["photo","entry"]},"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"date":{"type":"string","format":"date"},"created_at":{"type":"string","format":"date-time"},"mites":{"type":"integer"},"method":{"type":"string"},"effective_days":{"type":["number","null"],"description":"A tényleges napok: a beírt érték, különben a számolt (a kaptár előző hullásos számlálása, egy közbeeső kezelés kezdete, vagy a kezelés kezdete óta). Null, ha egyik sincs: nem kötött számlálás, a kezdet előtti vagy azon a napon készült számlálás, aznapi második számlálás, 60 napnál hosszabb idő, mosás, porcukros és CO₂-es módszer. Olvasáskor számolódik, nem tárolt."},"days_source":{"type":["string","null"],"enum":["typed","derived",null],"description":"typed: a felhasználó írta be; derived: a kaptár előző hullásos számlálásától, egy közbeeső kezelés kezdetétől vagy a kezelés kezdetétől számolt."},"mites_per_day":{"type":["number","null"],"description":"Atka/nap a tényleges napokból; százalékot adó módszernél és napok nélkül null."},"treatment_id":{"type":["string","null"],"pattern":"^[0-9a-f]{32}$","description":"A kezelés, amely alá a számlálás tartozik: közvetlenül (inspection_id) vagy a `varroa` bejegyzésén át."},"linked":{"type":"boolean","description":"false: nincs a kezeléshez kötve, csak összehasonlításhoz látszik."},"phase":{"type":"string","enum":["before","during","after"]},"used_in":{"type":["string","null"],"enum":["before","after",null],"description":"A jelzőszám melyik oldalához számít; null, ha nem számít."},"not_used_reason":{"type":["string","null"],"enum":["percent_method","treatment_drop","unmarked","no_days","during","no_end_date","overlaps_treatment","outside_window","other_treatment","earlier_treatment","open_ended_treatment","later_treatment",null]},"open_ended_treatment":{"type":["object","null"],"description":"open_ended_treatment oknál a kezelés (id, date), amelynek a végét meg kellene adni. Vég nélkül 30 naposnak vesszük."}}}},"success":{"type":"object","description":"Tájékoztató érték, nem ítélet: a természetes hullást a fiasítás mennyisége is meghatározza.","properties":{"status":{"type":"string","enum":["ok","not_enough_data"]},"reason":{"type":["string","null"],"enum":["no_end_date","no_counts","no_before","no_after","zero_before",null]},"before":{"type":"object","properties":{"counts":{"type":"integer"},"mites":{"type":"integer"},"days":{"type":"number"},"mites_per_day":{"type":["number","null"]}}},"after":{"type":"object","properties":{"counts":{"type":"integer"},"mites":{"type":"integer"},"days":{"type":"number"},"mites_per_day":{"type":["number","null"]}}},"drop_pct":{"type":["integer","null"],"description":"Százalékos csökkenés; negatív, ha nőtt. Null, ha nincs elég adat."},"settling":{"type":"boolean","description":"Az „utána” értékben van settling_days napon belül a kezelés vége után kezdett gyűjtés: a hullás még a kezelés hatása lehet."},"before_settling":{"type":"boolean","description":"Az „előtte” értékben van egy korábbi kezelés vége után settling_days napon belül kezdett gyűjtés: a hullás még a korábbi kezelés hatása lehet, így a csökkenés kisebb is lehet."},"low_sample":{"type":"boolean","description":"Van szám, de valamelyik oldal low_sample_days napnál kevesebb számlálásból áll."},"window_days":{"type":"integer"},"settling_days":{"type":"integer"},"low_sample_days":{"type":"integer"},"open_ended_treatments":{"type":"array","description":"Vég nélküli másik kezelések, amelyek miatt számlálás maradt ki: a végük megadásával több számíthat.","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"date":{"type":"string","format":"date"}}}}}}}},"HistoryEntry":{"type":"object","description":"Átvizsgálás vagy esemény az idővonalon.","required":["kind","id","date","time","recorded_at","data","count_ids"],"properties":{"kind":{"type":"string","enum":["inspection","treatment","feeding","harvest","queen","colony","weight"]},"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"date":{"type":"string","format":"date"},"time":{"type":["string","null"],"description":"ÓÓ:PP, ha meg van adva."},"recorded_at":{"type":"string","format":"date-time"},"data":{"type":"object","description":"A fajta mezői, ahogy az Entry `data` mezőjében, a rejtett szöveges mezők nélkül.","properties":{"duration_min":{"type":"integer","minimum":0,"maximum":600,"description":"Időtartam. Fajta: inspection."},"temperature_c":{"type":"integer","minimum":-30,"maximum":50,"description":"Hőmérséklet. Fajta: inspection."},"weather":{"type":"string","enum":["sunny","partly_cloudy","cloudy","windy","rain"],"description":"Időjárás. Fajta: inspection."},"queen_seen":{"type":"boolean","description":"Anyát láttam. Fajta: inspection."},"eggs_seen":{"type":"boolean","description":"Petét láttam. Fajta: inspection. A pete a petéző anya legbiztosabb jele."},"queen_cells":{"type":"string","enum":["none","cups","swarm","supersedure","emergency"],"description":"Anyabölcső. Fajta: inspection. Nincs: egyáltalán nincs bölcső. Ha csak kikelt vagy oldalt kibontott bölcsőt láttál, hagyd üresen."},"queen_cell_state":{"type":"array","items":{"type":"string","enum":["open","sealed","hatched","destroyed"]},"uniqueItems":true,"description":"Anyabölcsők állapota. Fajta: inspection. Minden látott állapot (pl. fedett és kikelt is); ha mind kikelt, csak a kikelt. Kikelt: a csúcsán kerek nyílás, gyakran visszahajló kupakkal. Oldalt kibontott: az oldalán szabálytalan lyuk; a méhész törlése az elvégzett munkák között van."},"bee_frames":{"type":"number","minimum":0,"maximum":60,"description":"Méhekkel fedett keretek (utcák). Fajta: inspection. Hány keretet (utcát) fednek a méhek, a kaptár összes fiókjában együtt. Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400."},"brood_frames":{"type":"number","minimum":0,"maximum":60,"description":"Fiasításos keretek. Fajta: inspection. Hány kereten van fiasítás (bármilyen: pete, nyitott, fedett, bármennyi), a kaptár összes fiókjában együtt. Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400."},"brood_pattern":{"type":"integer","minimum":1,"maximum":5,"description":"Fiasítás zártsága (1 hézagos – 5 zárt). Fajta: inspection."},"open_brood":{"type":"boolean","description":"Nyitott fiasítás. Fajta: inspection."},"sealed_brood":{"type":"boolean","description":"Fedett fiasítás. Fajta: inspection."},"drone_brood":{"type":"boolean","description":"Herefiasítás. Fajta: inspection."},"honey_frames":{"type":"number","minimum":0,"maximum":60,"description":"Mézes keretek. Fajta: inspection. Teli keretnyi mennyiségben: teli keret 1, félig teli keret 0,5, mézkoszorú kb. 0,25, kevés 0. A kaptár összes fiókjában együtt, fél keretre kerekítve (a negyed felfelé). Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400."},"pollen_frames":{"type":"number","minimum":0,"maximum":60,"description":"Virágporos keretek. Fajta: inspection. Teli keretnyi mennyiségben: teli keret 1, félig teli keret 0,5, koszorú kb. 0,25, kevés 0. A kaptár összes fiókjában együtt, fél keretre kerekítve (a negyed felfelé). Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400."},"needs_feeding":{"type":"boolean","description":"Etetni kell. Fajta: inspection."},"temperament":{"type":"integer","minimum":1,"maximum":5,"description":"Viselkedés (1 szelíd – 5 támadó). Fajta: inspection."},"on_frames":{"type":"string","enum":["calm","nervous","running"],"description":"A kereteken. Fajta: inspection."},"swarm_signs":{"type":"boolean","description":"Rajzási hangulat. Fajta: inspection."},"actions":{"type":"array","items":{"type":"string","enum":["super_added","super_removed","brood_box_added","foundation_added","frames_moved","brood_removed","split_made","queen_cells_removed","excluder","entrance_reduced"]},"uniqueItems":true,"description":"Elvégzett munkák. Fajta: inspection."},"health_signs":{"type":"array","items":{"type":"string","enum":["chalkbrood","sacbrood","foulbrood_suspect","dwv","nosema","wax_moth","small_hive_beetle","wasps","robbing","varroa_visible","other"]},"uniqueItems":true,"description":"Betegség, kártevő. Fajta: inspection. A költésrothadás és a kis kaptárbogár gyanúját a hatósági állatorvosnak be kell jelenteni."},"method":{"type":"string","enum":["natural_drop","treatment_drop","alcohol_wash","sugar_roll","co2"],"description":"Módszer. Fajta: varroa."},"mites":{"type":"integer","minimum":0,"maximum":100000,"description":"Atkák száma. Fajta: varroa."},"exposure_days":{"type":"number","minimum":0.5,"maximum":60,"description":"Napok az aljdeszkán. Fajta: varroa. Hullásnál kötelező, ha atkaszámot írsz be: hány napig gyűlt az aljdeszkán. Ebből lesz az atka/nap. Kezeléshez kötött számlálásnál elhagyható, ha kiszámolható. Csak a 0,5 többszöröse lehet (lépték: 0.5), egyébként 400."},"treatment_id":{"type":"string","pattern":"^[0-9a-f]{32}$","description":"Kezelés. Fajta: varroa. A kaptár kezelése, amelyhez ez a számlálás tartozik. Ugyanannak a kaptárnak `treatment` bejegyzése; más kaptáré vagy más felhasználóé 404. A kezelés törlése a kötést törli, a számlálást megtartja."},"sample_bees":{"type":"integer","minimum":1,"maximum":2000,"description":"Minta (méh). Fajta: varroa. Mosásnál, porcukros módszernél: kb. 300 méh ≈ fél dl."},"product":{"type":"string","maxLength":100,"description":"Készítmény. Fajta: treatment."},"active_ingredient":{"type":"string","enum":["oxalic_acid","formic_acid","lactic_acid","amitraz","thymol","tau_fluvalinate","flumethrin","other"],"description":"Hatóanyag. Fajta: treatment."},"treatment_method":{"type":"string","enum":["trickle","sublimation","spray","fumigation","strip","evaporator","other"],"description":"Alkalmazás módja. Fajta: treatment."},"dose":{"type":"number","minimum":0,"maximum":10000,"description":"Mennyiség. Fajta: treatment. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400."},"dose_unit":{"type":"string","enum":["ml","g","strip","pad","tablet","other"],"description":"Egység. Fajta: treatment."},"end_date":{"type":"string","format":"date","description":"Kezelés vége. Fajta: treatment. Egynapos kezelésnél a kezdő nap. Enélkül nem számolható, mennyit változott a hullás a kezelés után."},"batch":{"type":"string","maxLength":60,"description":"Gyártási tétel (sarzs). Fajta: treatment."},"withdrawal_days":{"type":"integer","minimum":0,"maximum":365,"description":"Élelmezés-egészségügyi várakozási idő. Fajta: treatment. A nulla napot is be kell írni."},"supplier":{"type":"string","maxLength":200,"description":"Beszerzés helye (forgalmazó neve, címe). Fajta: treatment."},"purchase_ref":{"type":"string","maxLength":60,"description":"Számla / bizonylat száma. Fajta: treatment."},"vet":{"type":"string","maxLength":200,"description":"Állatorvos (ha rendelte). Fajta: treatment."},"prescription_number":{"type":"string","maxLength":60,"description":"Recept száma. Fajta: treatment. Az állatorvosi recept száma, ha van."},"feed_type":{"type":"string","enum":["syrup_1_1","syrup_3_2","syrup_2_1","invert_syrup","fondant","pollen_patty","honey","other"],"description":"Takarmány. Fajta: feeding."},"amount":{"type":"number","minimum":0,"maximum":1000,"description":"Mennyiség. Fajta: feeding. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400."},"amount_unit":{"type":"string","enum":["kg","l"],"description":"Egység. Fajta: feeding."},"honey_kg":{"type":"number","minimum":0,"maximum":1000,"description":"Méz. Fajta: harvest. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400."},"honey_type":{"type":"string","enum":["acacia","rapeseed","sunflower","linden","milkweed","phacelia","chestnut","lavender","goldenrod","honeydew","mixed","other"],"description":"Méz fajtája. Fajta: harvest."},"supers_taken":{"type":"integer","minimum":0,"maximum":20,"description":"Elvett mézkamrák. Fajta: harvest."},"frames_taken":{"type":"integer","minimum":0,"maximum":200,"description":"Elvett keretek. Fajta: harvest."},"queen_event":{"type":"string","enum":["introduced","replaced","superseded","lost","marked","clipped"],"description":"Esemény. Fajta: queen."},"queen_year":{"type":"integer","minimum":2000,"maximum":2100,"description":"Az új anya születési éve. Fajta: queen."},"queen_breed":{"type":"string","maxLength":60,"description":"Fajta. Fajta: queen."},"queen_source":{"type":"string","maxLength":100,"description":"Származás. Fajta: queen."},"colony_event":{"type":"string","enum":["split","merged","swarmed","moved","overwintered","died"],"description":"Esemény. Fajta: colony."},"apiary_id":{"type":"string","pattern":"^[0-9a-f]{32}$","description":"Új méhes. Fajta: colony. Saját méhes azonosítója."},"death_cause":{"type":"string","enum":["varroa","starvation","queenless","robbing","poisoning","cold","unknown","other"],"description":"Pusztulás oka. Fajta: colony."},"weight_kg":{"type":"number","minimum":0,"maximum":300,"description":"Tömeg. Fajta: weight, inspection. Csak a 0,1 többszöröse lehet (lépték: 0.1), egyébként 400."},"weight_source":{"type":"string","enum":["scale","manual","hefting"],"description":"Mérés módja. Fajta: weight, inspection."}}},"count_ids":{"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{32}$"},"description":"A bejegyzéshez kötött fotós számlálások."},"notes":{"type":"string","description":"Csak include_notes=true mellett."},"todo":{"type":"string","description":"Csak include_notes=true mellett."}}},"HistoryMiteCount":{"type":"object","description":"Egy atkaszámlálás. Eredményenként egy tétel; a fotóhoz kötött bejegyzés és a fotó nem számít kétszer.","required":["kind","id","date","time","recorded_at","source","is_measurement","not_measurement_reason","series","series_basis","during_treatment","during_treatment_id","settling","in_natural_figures","mites","effective_days","days_source","mites_per_day","treatment_id","paired"],"properties":{"kind":{"type":"string","const":"mite_count"},"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"date":{"type":"string","format":"date"},"time":{"type":["string","null"],"description":"A fotónak nincs."},"recorded_at":{"type":"string","format":"date-time"},"source":{"type":"string","enum":["photo","entry"],"description":"photo: az `id` számlálás-, entry: naplóbejegyzés-azonosító."},"is_measurement":{"type":"boolean","description":"false: jelölés nélküli fotó vagy szám nélküli bejegyzés (az ok a not_measurement_reason). Ilyenkor egyik számításba sem kerül (in_natural_figures: false, összesítő, jelzőszám)."},"not_measurement_reason":{"type":["string","null"],"enum":["no_marks","no_mites",null],"description":"Null, ha mérés. no_marks: a fotón nincs jelölés. A mites 0 (0 jelölés), az atka/nap is látszik (0), ahogy a kaptár oldalán; a fertőzöttség null. A tábla lehetett atkamentes, de a fotó lehet még jelöletlen is, ezt az adat nem tudja megkülönböztetni. A beírt 0 (varroa bejegyzés, mites: 0) mérés. no_mites: szám nélküli bejegyzés, a mites null."},"method":{"type":["string","null"],"description":"A fotó módszere, vagy ha nincs, a bejegyzéséé; null, ha nincs megadva (azt természetes hullásnak vesszük)."},"series":{"type":"string","enum":["natural","treatment","percent"],"description":"natural: természetes hullás (natural_drop, vagy módszer nélkül a kezelésen kívül gyűlt számlálás); treatment: kezelés utáni hullás (treatment_drop), vagy módszer nélkül a kezelés alatt gyűlt számlálás; percent: mosás, porcukros, CO₂-es. A sorozatok nem keverednek; a kezelés alatt gyűlt natural_drop sorozata natural marad, de az in_natural_figures false."},"series_basis":{"type":"string","enum":["method","no_method","no_method_during_treatment"],"description":"Miért ez a sorozat: a módszerből; nincs módszer, természetesnek vesszük; nincs módszer, és a kezelés alatt gyűlt."},"during_treatment":{"type":"boolean","description":"A gyűjtés kezelés idejére esik, ugyanazzal a szabállyal, mint a GET /treatments/{id} nézetben: a kezdet után készült, és a kezelés vége előtt készült, vagy a gyűjtése a vége előtt kezdődött. A saját, vég nélküli kezelés alatt minden későbbi számlálás ilyen; más vég nélküli kezelést 30 naposnak veszünk."},"during_treatment_id":{"type":["string","null"],"pattern":"^[0-9a-f]{32}$","description":"A kezelés, amelynek az idejére esik; több esetén a kötött, különben az első."},"settling":{"type":"boolean","description":"Nem kezelés alatt gyűlt, de a gyűjtés a kezelés (vagy feltételezett vége) után 14 napon belül kezdődött: a hullás még a kezelés hatása lehet. A természetes számokban benne marad, ahogy a jelzőszámban is, ott a `settling` jelöli."},"in_natural_figures":{"type":"boolean","description":"Beleszámít-e a természetes hullás számaiba (utolsó érték, trend), ugyanazzal a szabállyal, mint az összesítő: természetes sorozat, mérés, van atka/nap, nem kezelés alatt gyűlt, és nem a mai (budapesti) nap utáni. A kezelés alatt gyűlt natural_drop látszik, de nem számít bele."},"mites":{"type":["integer","null"],"minimum":0,"description":"Az atkaszám. is_measurement: true mellett a 0 megszámolt nulla. not_measurement_reason: no_marks mellett a 0 a fotó 0 jelölése: lehet, hogy még nincs megjelölve, atkamentességet nem jelent. null: nincs atkaszám (no_mites)."},"effective_days":{"type":["number","null"],"description":"A tényleges napok: a beírt érték, különben a számolt (a kaptár előző hullásos számlálása, egy közbeeső kezelés kezdete, vagy a kezelés kezdete óta). Null, ha egyik sincs: nem kötött számlálás, a kezdet előtti vagy azon a napon készült számlálás, aznapi második számlálás, 60 napnál hosszabb idő, mosás, porcukros és CO₂-es módszer. Olvasáskor számolódik, nem tárolt."},"days_source":{"type":["string","null"],"enum":["typed","derived",null],"description":"typed: a felhasználó írta be; derived: a kaptár előző hullásos számlálásától, egy közbeeső kezelés kezdetétől vagy a kezelés kezdetétől számolt."},"mites_per_day":{"type":["number","null"],"description":"Atka/nap a tényleges napokból; százalékot adó módszernél és napok nélkül null."},"treatment_id":{"type":["string","null"],"pattern":"^[0-9a-f]{32}$","description":"A kezelés, amely alá a számlálás tartozik: közvetlenül (inspection_id) vagy a `varroa` bejegyzésén át."},"sample_bees":{"type":["integer","null"]},"infestation_pct":{"type":["number","null"],"description":"Fertőzöttség százalékban, csak mérésnél (is_measurement: true); különben null, a no_marks fotónál is."},"inspection_id":{"type":["string","null"],"pattern":"^[0-9a-f]{32}$","description":"Fotónál a naplóbejegyzés, amelyhez kötött."},"paired":{"type":"array","description":"A pár kimaradó fele: ugyanannak az aljdeszkának a számlálása, amely nem ad külön eredményt.","items":{"type":"object","properties":{"source":{"type":"string","enum":["photo","entry"]},"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"date":{"type":"string","format":"date"},"notes":{"type":"string"},"todo":{"type":"string"}}}},"notes":{"type":"string","description":"Csak include_notes=true mellett."},"todo":{"type":"string","description":"Csak include_notes=true mellett, bejegyzésnél."}}},"HiveSummary":{"type":"object","properties":{"as_of":{"type":"string","format":"date","description":"A számítás napja (budapesti dátum, Europe/Budapest). Az ennél későbbi dátumú sorok nem kerülnek az „utolsó” és az összesített értékekbe."},"future_rows_ignored":{"type":"integer","description":"Hány as_of utáni sor maradt ki: bejegyzés és fotó, a pár kimaradó fele is. Az idővonalon látszanak; a jövő dátumú teendő nyitottként számít."},"hive":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"name":{"type":"string"},"number":{"type":"string"},"status":{"type":"string"},"apiary":{"type":["object","null"],"properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"name":{"type":"string"}}},"notes":{"type":"string","description":"Csak include_notes=true mellett."}}},"queen":{"type":"object","description":"A jelenlegi anya: az adatlapból, de a legutóbbi anyaváltó esemény (introduced, replaced, superseded, lost) után csak abból, amit az esemény tud, mert az adatlapnak nincs előzménye, és az évét a csere nem mindig írja át. A kézzel átírt adatlap akkor számít újra, ha a queen_introduced_on későbbi az eseménynél. Inkább null, mint egy régi anya kora.","properties":{"year":{"type":["integer","null"]},"age_years":{"type":["integer","null"],"description":"A születési évből, az as_of évében. Null, ha nem tudható: lásd age_unknown_reason."},"age_unknown_reason":{"type":["string","null"],"enum":["no_queen_year","queen_changed_year_unknown","queen_lost","colony_gone","year_in_future",null],"description":"no_queen_year: nincs megadva év; queen_changed_year_unknown: anyaváltás, az esemény nem adta meg az évet; queen_lost: anyátlan; colony_gone: a család elpusztult, egyesítve vagy eladva; year_in_future: a megadott év az as_of utáni."},"colour":{"type":["string","null"]},"breed":{"type":["string","null"]},"marked":{"type":["boolean","null"]},"clipped":{"type":["boolean","null"]},"introduced_on":{"type":["string","null"],"format":"date"},"last_seen_on":{"type":["string","null"],"format":"date"},"last_eggs_seen_on":{"type":["string","null"],"format":"date"},"last_event":{"type":["object","null"],"properties":{"date":{"type":"string","format":"date"},"event":{"type":"string","enum":["introduced","replaced","superseded","lost","marked","clipped"]}}},"source":{"type":["string","null"],"description":"Csak include_notes=true mellett."}}},"last_inspection_on":{"type":["string","null"],"format":"date"},"days_since_last_inspection":{"type":["integer","null"]},"colony_strength":{"type":"object","description":"A méhekkel fedett keretek (bee_frames) két utolsó értékéből, a compared mezőben. 1 keretnél kisebb változás: flat. 180 napnál távolabbi mérésekből nincs trend. A határok a mi döntésünk, nem forrásból valók (`source: own_choice`).","properties":{"latest":{"type":["object","null"],"description":"A legutóbbi mérés; a bee_frames null lehet, ha csak fiasítás van benne.","properties":{"date":{"type":"string","format":"date"},"bee_frames":{"type":["number","null"]},"brood_frames":{"type":["number","null"]}}},"compared":{"type":["object","null"],"description":"A két mérés, amelyből a változás és a trend jön; a latest-től eltérhet.","properties":{"previous":{"type":"object","properties":{"date":{"type":"string","format":"date"},"bee_frames":{"type":"number"}}},"last":{"type":"object","properties":{"date":{"type":"string","format":"date"},"bee_frames":{"type":"number"}}}}},"days_between":{"type":["integer","null"]},"bee_frames_change":{"type":["number","null"]},"trend":{"type":["string","null"],"enum":["rising","falling","flat",null]},"stale":{"type":["boolean","null"],"description":"Az utolsó bee_frames mérés 60 napnál régebbi: a trend nem a mostani állapotot mutatja. Null, ha nincs mérés."},"thresholds":{"type":"object","properties":{"flat_frames":{"type":"number"},"max_gap_days":{"type":"integer"},"stale_days":{"type":"integer"},"source":{"type":"string","const":"own_choice"}}}}},"mites":{"type":"object","properties":{"natural":{"type":"object","properties":{"last":{"type":["object","null"],"description":"A sorozat utolsó napja; null, ha nincs mérés. Több aznapi számlálásnál az összes atka osztva az összes nappal, ahogy a görbén. Jelöletlen fotó és napok nélküli számlálás nem számít; a természetes sorozatba a kezelés alatt gyűlt sem.","properties":{"date":{"type":"string","format":"date"},"mites":{"type":"integer"},"days":{"type":"number"},"mites_per_day":{"type":"number"},"counts":{"type":"integer"},"days_source":{"type":"string","enum":["typed","derived"],"description":"derived: legalább az egyik érték számolt napokból jön, olvasáskor számolva."},"settling":{"type":"boolean","description":"A gyűjtés a kezelés (vagy feltételezett vége) után 14 napon belül kezdődött: a hullás még a kezelés hatása lehet."},"treatment_ids":{"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{32}$"},"description":"A kezelések, amelyekhez ezek a számlálások kötöttek."},"result_ids":{"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{32}$"}}}},"measurements":{"type":"integer"},"trend":{"type":"object","description":"Csak a kezelésen kívül gyűlt természetes hullásból: a legutóbbi mérés napjával (ending_on) végződő 30 nap és az előtte levő 30 nap, mindkettő összes atka / összes nap. 25%-nál kisebb változás: flat. Irány csak status: ok mellett van. Tájékoztató érték. A határok a mi döntésünk, nem forrásból valók (`source: own_choice`).","properties":{"status":{"type":"string","enum":["ok","not_enough_data","treatment_affected"],"description":"not_enough_data: nincs mérés, vagy az előző ablak üres (a recent ilyenkor is lehet). treatment_affected: a felhasznált gyűjtéseket kezelés vagy annak utóhatása érinti, a recent és az earlier megvan, de irány nincs."},"direction":{"type":["string","null"],"enum":["rising","falling","flat",null],"description":"Null, ha a status nem ok."},"change_pct":{"type":["integer","null"],"description":"Null, ha nincs irány, vagy az előző ablakban nulla volt a hullás."},"note":{"type":["string","null"],"description":"Miért nincs irány."},"ending_on":{"type":["string","null"],"format":"date","description":"A legutóbbi felhasznált mérés napja."},"days_since_end":{"type":["integer","null"],"description":"Az ending_on óta eltelt napok az as_of napig."},"stale":{"type":["boolean","null"],"description":"Az ending_on 60 napnál régebbi: a trend nem a mostani állapotot mutatja. Null, ha nincs mérés."},"recent":{"type":["object","null"],"properties":{"counts":{"type":"integer"},"mites":{"type":"integer"},"days":{"type":"number"},"mites_per_day":{"type":["number","null"]}}},"earlier":{"type":["object","null"],"properties":{"counts":{"type":"integer"},"mites":{"type":"integer"},"days":{"type":"number"},"mites_per_day":{"type":["number","null"]}}},"low_sample":{"type":["boolean","null"],"description":"Valamelyik ablak kevés számlálási napból áll. Null, ha nincs két ablak: ott nincs mit minősíteni."},"uses_derived_days":{"type":"boolean","description":"Van benne számolt napokból jövő érték."},"treatment_in_window":{"type":"boolean","description":"Van kezelés, amely a legutóbbi mérés előtt kezdődött, és a vége (vég nélkül a feltételezett 30. nap) plusz settling_days később van a legkorábbi felhasznált gyűjtés kezdeténél. Így a kezelés utóhatását és a hosszú gyűjtést is látja, nem csak a számlálás napját."},"treatments_in_window":{"type":"array","description":"Ezek a kezelések; end_date null, ha nincs megadva.","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"date":{"type":"string","format":"date"},"end_date":{"type":["string","null"],"format":"date"}}}},"thresholds":{"type":"object","description":"A számításhoz használt határok. Az open_ended_treatment_days a vég nélküli kezelésnek feltételezett hossz.","properties":{"window_days":{"type":"integer"},"flat_pct":{"type":"integer"},"low_sample_days":{"type":"integer"},"settling_days":{"type":"integer"},"open_ended_treatment_days":{"type":"integer"},"stale_days":{"type":"integer"},"source":{"type":"string","const":"own_choice"}}}}}}},"treatment":{"type":"object","properties":{"last":{"type":["object","null"],"description":"A sorozat utolsó napja; null, ha nincs mérés. Több aznapi számlálásnál az összes atka osztva az összes nappal, ahogy a görbén. Jelöletlen fotó és napok nélküli számlálás nem számít; a természetes sorozatba a kezelés alatt gyűlt sem.","properties":{"date":{"type":"string","format":"date"},"mites":{"type":"integer"},"days":{"type":"number"},"mites_per_day":{"type":"number"},"counts":{"type":"integer"},"days_source":{"type":"string","enum":["typed","derived"],"description":"derived: legalább az egyik érték számolt napokból jön, olvasáskor számolva."},"settling":{"type":"boolean","description":"A gyűjtés a kezelés (vagy feltételezett vége) után 14 napon belül kezdődött: a hullás még a kezelés hatása lehet."},"treatment_ids":{"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{32}$"},"description":"A kezelések, amelyekhez ezek a számlálások kötöttek."},"result_ids":{"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{32}$"}}}},"measurements":{"type":"integer"}}},"percent":{"type":"object","properties":{"last":{"type":["object","null"],"description":"A legutóbbi százalékot adó számlálás; null, ha nincs. Nem atka/nap, nem hasonlítható a hulláshoz.","properties":{"date":{"type":"string","format":"date"},"method":{"type":"string"},"mites":{"type":"integer"},"sample_bees":{"type":["integer","null"]},"infestation_pct":{"type":["number","null"]},"source":{"type":"string","enum":["photo","entry"]},"id":{"type":"string","pattern":"^[0-9a-f]{32}$"}}}}},"left_out":{"type":"object","properties":{"unmarked_photos":{"type":"integer","description":"A jelölés nélküli fotók (az idővonalon not_measurement_reason: no_marks, 0 atkával): nem mérések, mert a sor nem tudja, megszámolt nulla-e vagy még jelöletlen. A beírt 0 nem ide tartozik, az mérés."},"no_days":{"type":"integer","description":"Hullásos számlálások napok nélkül."},"during_treatment":{"type":"integer","description":"A kezelés alatt gyűlt, kifejezetten natural_drop számlálások: látszanak az idővonalon, de nincsenek a természetes számokban. A módszer nélküliek a treatment sorozatban vannak."}}}}},"last_treatment":{"type":["object","null"],"properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"date":{"type":"string","format":"date"},"end_date":{"type":["string","null"],"format":"date"},"product":{"type":["string","null"]},"active_ingredient":{"type":["string","null"]},"treatment_method":{"type":["string","null"]},"before_after":{"allOf":[{"type":"object","description":"Tájékoztató érték, nem ítélet: a természetes hullást a fiasítás mennyisége is meghatározza.","properties":{"status":{"type":"string","enum":["ok","not_enough_data"]},"reason":{"type":["string","null"],"enum":["no_end_date","no_counts","no_before","no_after","zero_before",null]},"before":{"type":"object","properties":{"counts":{"type":"integer"},"mites":{"type":"integer"},"days":{"type":"number"},"mites_per_day":{"type":["number","null"]}}},"after":{"type":"object","properties":{"counts":{"type":"integer"},"mites":{"type":"integer"},"days":{"type":"number"},"mites_per_day":{"type":["number","null"]}}},"drop_pct":{"type":["integer","null"],"description":"Százalékos csökkenés; negatív, ha nőtt. Null, ha nincs elég adat."},"settling":{"type":"boolean","description":"Az „utána” értékben van settling_days napon belül a kezelés vége után kezdett gyűjtés: a hullás még a kezelés hatása lehet."},"before_settling":{"type":"boolean","description":"Az „előtte” értékben van egy korábbi kezelés vége után settling_days napon belül kezdett gyűjtés: a hullás még a korábbi kezelés hatása lehet, így a csökkenés kisebb is lehet."},"low_sample":{"type":"boolean","description":"Van szám, de valamelyik oldal low_sample_days napnál kevesebb számlálásból áll."},"window_days":{"type":"integer"},"settling_days":{"type":"integer"},"low_sample_days":{"type":"integer"},"open_ended_treatments":{"type":"array","description":"Vég nélküli másik kezelések, amelyek miatt számlálás maradt ki: a végük megadásával több számíthat.","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"date":{"type":"string","format":"date"}}}}}},{"type":"object","properties":{"is_indication":{"type":"boolean","const":true},"note":{"type":"string"}}}],"description":"Az átlagos természetes hullás a kezelés előtt és után, ugyanaz, mint a GET /treatments/{id} `success` mezője. Jelzés, nem hatékonyságmérés."}}},"stores":{"type":"object","description":"A legutóbbi mért értékek, értékelés nélkül. A honey_frames, pollen_frames és needs_feeding egy átvizsgálásból jön (on): ami abban nincs megadva, az null, akkor is, ha egy korábbi tartalmazta.","properties":{"on":{"type":["string","null"],"format":"date","description":"A legutóbbi átvizsgálás, ahol a készlet meg van adva."},"honey_frames":{"type":["number","null"]},"pollen_frames":{"type":["number","null"]},"needs_feeding":{"type":["boolean","null"]},"weight_kg":{"type":["number","null"]},"weight_on":{"type":["string","null"],"format":"date"},"last_feeding":{"type":["object","null"],"properties":{"date":{"type":"string","format":"date"},"feed_type":{"type":["string","null"]},"amount":{"type":["number","null"]},"amount_unit":{"type":["string","null"]}}}}},"harvest":{"type":"object","description":"A season_year naptári évben.","properties":{"season_year":{"type":"integer"},"harvest_kg":{"type":"number"},"harvests":{"type":"integer"},"last_on":{"type":["string","null"],"format":"date"}}},"open_todos":{"type":"object","description":"A naplónak nincs „kész” jelölése: nyitottnak a legutóbbi átvizsgálás napján vagy utána írt teendő számít (ha nem volt átvizsgálás, mind). Ez becslés, nem tárolt állapot; ha a napló „kész” jelölést kap, a halmaz szűkülhet. A szöveg csak include_notes=true mellett. Legfeljebb 20 tétel, a legújabb elöl.","properties":{"count":{"type":"integer"},"since":{"type":["string","null"],"format":"date"},"items":{"type":"array","items":{"type":"object","properties":{"entry_id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"kind":{"type":"string"},"date":{"type":"string","format":"date"},"todo":{"type":"string"}}}}}}}},"ApiaryOverview":{"type":"object","properties":{"apiary":{"type":["object","null"],"description":"Null a `none` azonosítónál.","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"name":{"type":"string"}}},"as_of":{"type":"string","format":"date"},"hives":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{32}$"},"name":{"type":"string"},"number":{"type":"string"},"status":{"type":"string"},"last_inspection_on":{"type":["string","null"],"format":"date"},"strength":{"type":["object","null"],"properties":{"date":{"type":"string","format":"date"},"bee_frames":{"type":["number","null"]},"brood_frames":{"type":["number","null"]}}},"last_treatment_on":{"type":["string","null"],"format":"date"},"mites":{"type":"object","properties":{"natural":{"type":["object","null"],"description":"A sorozat utolsó napja; null, ha nincs mérés. Több aznapi számlálásnál az összes atka osztva az összes nappal, ahogy a görbén. Jelöletlen fotó és napok nélküli számlálás nem számít; a természetes sorozatba a kezelés alatt gyűlt sem.","properties":{"date":{"type":"string","format":"date"},"mites":{"type":"integer"},"days":{"type":"number"},"mites_per_day":{"type":"number"},"counts":{"type":"integer"},"days_source":{"type":"string","enum":["typed","derived"],"description":"derived: legalább az egyik érték számolt napokból jön, olvasáskor számolva."},"settling":{"type":"boolean","description":"A gyűjtés a kezelés (vagy feltételezett vége) után 14 napon belül kezdődött: a hullás még a kezelés hatása lehet."},"treatment_ids":{"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{32}$"},"description":"A kezelések, amelyekhez ezek a számlálások kötöttek."},"result_ids":{"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{32}$"}}}},"treatment":{"type":["object","null"],"description":"A sorozat utolsó napja; null, ha nincs mérés. Több aznapi számlálásnál az összes atka osztva az összes nappal, ahogy a görbén. Jelöletlen fotó és napok nélküli számlálás nem számít; a természetes sorozatba a kezelés alatt gyűlt sem.","properties":{"date":{"type":"string","format":"date"},"mites":{"type":"integer"},"days":{"type":"number"},"mites_per_day":{"type":"number"},"counts":{"type":"integer"},"days_source":{"type":"string","enum":["typed","derived"],"description":"derived: legalább az egyik érték számolt napokból jön, olvasáskor számolva."},"settling":{"type":"boolean","description":"A gyűjtés a kezelés (vagy feltételezett vége) után 14 napon belül kezdődött: a hullás még a kezelés hatása lehet."},"treatment_ids":{"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{32}$"},"description":"A kezelések, amelyekhez ezek a számlálások kötöttek."},"result_ids":{"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{32}$"}}}},"percent":{"type":["object","null"],"description":"A legutóbbi százalékot adó számlálás; null, ha nincs. Nem atka/nap, nem hasonlítható a hulláshoz.","properties":{"date":{"type":"string","format":"date"},"method":{"type":"string"},"mites":{"type":"integer"},"sample_bees":{"type":["integer","null"]},"infestation_pct":{"type":["number","null"]},"source":{"type":"string","enum":["photo","entry"]},"id":{"type":"string","pattern":"^[0-9a-f]{32}$"}}}}}}}}}},"CountDetail":{"allOf":[{"$ref":"#/components/schemas/CountSummary"},{"type":"object","properties":{"marks":{"type":"array","items":{"$ref":"#/components/schemas/Mark"}}}}]},"Mark":{"type":"object","required":["id","x","y"],"description":"Pixelkoordináta az EXIF-forgatás utáni képen; origó a bal felső sarok.","properties":{"id":{"type":"integer","minimum":1},"x":{"type":"number","minimum":0},"y":{"type":"number","minimum":0},"created":{"type":"string","maxLength":40}}}}}}