{"openapi":"3.1.0","info":{"title":"Reptile Husbandry API","version":"1.0.0","description":"Reptile-husbandry maths as an API, computed locally and deterministically — the keeper numbers behind a healthy vivarium, so the setup is right before the animal moves in. The enclosure endpoint turns an animal length and its habit into the minimum floor length, width and height: terrestrial snakes want a floor at least as long as the snake (a 48-inch corn snake → a 48 × 24 × 24 inch minimum, eight square feet of floor), arboreal species trade floor for height (an 18-inch chameleon → 27 × 18 × 36 inches, tall), and ground lizards and tortoises need far more floor than their body length. The uvb endpoint gives the UV-B target by Ferguson zone — the 1-to-4 classification from Baines et al. (2016) of how much sun a species basks in — returning the mean and basking UV-index ranges (zone 3 open baskers want a basking UVI of 2.9–7.4), and, if you pass a lamp UVI measured at a reference distance, an inverse-square estimate of the mounting distance for the right basking UVI. The feeding endpoint sizes prey from body weight and life stage: a meal of roughly 10–15 % of body weight, no wider than the animal, on an interval that lengthens with age — a 500 g adult snake takes a 40–60 g prey item every fortnight. Everything is computed locally and deterministically, so it is instant and private. Ideal for reptile-keeper and herpetoculture apps, pet-store and breeder tools, vivarium-planning calculators, and care-sheet sites. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 compute endpoints. Educational husbandry estimates — not veterinary advice; research your exact species.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/reptile-api","description":"oanor gateway"}],"tags":[{"name":"Reptile"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/enclosure":{"get":{"operationId":"get_v1_enclosure","tags":["Reptile"],"summary":"Minimum enclosure size","description":"","parameters":[{"name":"length_in","in":"query","required":true,"description":"Animal total length in inches","schema":{"type":"string"},"example":"48"},{"name":"type","in":"query","required":false,"description":"terrestrial_snake | arboreal_snake | terrestrial_lizard | arboreal_lizard | tortoise","schema":{"type":"string"},"example":"terrestrial_snake"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/feeding":{"get":{"operationId":"get_v1_feeding","tags":["Reptile"],"summary":"Prey size and feeding interval","description":"","parameters":[{"name":"body_weight_g","in":"query","required":true,"description":"Body weight in grams","schema":{"type":"string"},"example":"500"},{"name":"life_stage","in":"query","required":false,"description":"hatchling | juvenile | subadult | adult","schema":{"type":"string"},"example":"adult"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/uvb":{"get":{"operationId":"get_v1_uvb","tags":["Reptile"],"summary":"UV-B Ferguson-zone target","description":"","parameters":[{"name":"ferguson_zone","in":"query","required":true,"description":"Ferguson zone 1-4","schema":{"type":"string"},"example":"3"},{"name":"lamp_uvi_at_distance","in":"query","required":false,"description":"Measured lamp UVI at the reference distance","schema":{"type":"string"},"example":"10"},{"name":"lamp_reference_in","in":"query","required":false,"description":"Reference distance in inches (default 12)","schema":{"type":"string"},"example":"12"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":250,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":540,"monthly_call_quota":7500,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1790,"monthly_call_quota":52000,"rps_limit":13,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5290,"monthly_call_quota":185000,"rps_limit":32,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/reptile-api"}