{ "openapi": "3.0.1", "info": { "title": "Net Zero Watering", "description": "Apply only the water the plant used. Weather, rain, and plant type in — litres or gallons out.", "version": "0.0", "x-build-id": "RJpL8dMjWogYq81WR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sciguy~evapotranspiration/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sciguy-evapotranspiration", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sciguy~evapotranspiration/runs": { "post": { "operationId": "runs-sync-sciguy-evapotranspiration", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sciguy~evapotranspiration/run-sync": { "post": { "operationId": "run-sync-sciguy-evapotranspiration", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "units", "relative_humidity", "latitude", "precip_since_last", "precip_forecast_until_next" ], "properties": { "units": { "title": "Units", "enum": [ "metric", "imperial" ], "type": "string", "description": "Unit system for every quantity in this request and in the response. metric uses litres and m² (depths in mm). imperial uses US gallons and ft² (depths in inches)." }, "canopy_area": { "title": "Canopy area", "minimum": 0, "type": "number", "description": "Wettable canopy area. m² if units=metric, ft² if units=imperial. If you also fill pot_diameter, canopy_area is used." }, "pot_diameter": { "title": "Pot diameter", "minimum": 0, "type": "number", "description": "Pot or canopy diameter used to compute a circular area. m if units=metric, ft if units=imperial. Ignored when canopy_area is set. Leave empty if you already filled canopy area." }, "temperature": { "title": "Mean temperature", "type": "number", "description": "Mean air temperature. °C if units=metric, °F if units=imperial. Provide this, or both tmin and tmax." }, "tmin": { "title": "Minimum temperature", "type": "number", "description": "Daily minimum temperature. °C if units=metric, °F if units=imperial." }, "tmax": { "title": "Maximum temperature", "type": "number", "description": "Daily maximum temperature. °C if units=metric, °F if units=imperial." }, "relative_humidity": { "title": "Relative humidity", "minimum": 0, "maximum": 100, "type": "number", "description": "Mean relative humidity (%)." }, "pressure": { "title": "Atmospheric pressure", "minimum": 0, "type": "number", "description": "Barometric pressure. hPa if units=metric, inHg if units=imperial. Preferred over elevation. If both pressure and elevation are empty, elevation is treated as sea level (0)." }, "pressure_type": { "title": "Pressure type", "enum": [ "absolute", "sea_level" ], "type": "string", "description": "absolute is station pressure at the plant. sea_level is the reduced sea-level value many weather APIs send; that option also requires elevation.", "default": "absolute" }, "elevation": { "title": "Elevation", "type": "number", "description": "Site elevation above sea level. m if units=metric, ft if units=imperial. Used to estimate pressure, or to reduce sea-level pressure to station pressure." }, "latitude": { "title": "Latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Site latitude in decimal degrees (north positive). Needed to estimate solar radiation when solar_radiation is omitted." }, "precip_since_last": { "title": "Precipitation since last watering", "minimum": 0, "type": "number", "description": "Rain already received since the last watering. mm if units=metric, inches if units=imperial. 0 is allowed.", "default": 0 }, "precip_forecast_until_next": { "title": "Forecast precipitation until next watering", "minimum": 0, "type": "number", "description": "Rain expected before the next watering. mm if units=metric, inches if units=imperial. 0 is allowed.", "default": 0 }, "date": { "title": "Date", "type": "string", "description": "Date for solar geometry (YYYY-MM-DD). Defaults to today UTC." }, "days_since_last": { "title": "Days since last watering", "minimum": 0, "type": "number", "description": "Days of evapotranspiration already accumulated since the last watering.", "default": 1 }, "days_until_next": { "title": "Days until next watering", "minimum": 0, "type": "number", "description": "Days until the next planned watering.", "default": 1 }, "wind_speed": { "title": "Wind speed", "minimum": 0, "type": "number", "description": "Wind speed. m/s if units=metric, mph if units=imperial. Defaults to the FAO-56 standard of 2 m/s after conversion." }, "wind_height": { "title": "Wind measurement height (m)", "minimum": 0, "type": "number", "description": "Height of the wind sensor above the surface, always in metres. Airport and OpenWeather winds are often 10 m.", "default": 2 }, "solar_radiation": { "title": "Solar radiation", "minimum": 0, "type": "number", "description": "Incoming shortwave solar radiation. MJ m⁻² day⁻¹ if units=metric, Langley/day if units=imperial. Estimated from temperature when omitted." }, "sunshine_hours": { "title": "Sunshine hours", "minimum": 0, "maximum": 24, "type": "number", "description": "Bright sunshine duration in hours. Used to estimate solar radiation when solar_radiation is omitted." }, "coastal": { "title": "Coastal site", "type": "boolean", "description": "Set true if air masses are influenced by a nearby large water body. Only used when solar radiation is estimated from temperature.", "default": false }, "dewpoint": { "title": "Dewpoint", "type": "number", "description": "Dewpoint temperature (°C metric, °F imperial). Preferred over relative humidity for actual vapour pressure." }, "plant_type": { "title": "Plant type", "type": "string", "description": "Plant key from the bundled Kc table, e.g. tomato, onions-dry, turf-grass-cool-season. See PLANTS.md for the full list. Unknown or omitted keys use Kc 0.8." }, "plant_age_years": { "title": "Plant age (years)", "minimum": 0, "type": "number", "description": "Selects an age bucket 0–10 in the Kc table. Buckets currently copy the same Kc; age-specific values can replace them later." }, "growth_stage": { "title": "Growth stage", "enum": [ "ini", "mid", "end" ], "type": "string", "description": "Override growth stage (ini / mid / end). If omitted, inferred from date and latitude." }, "kc": { "title": "Crop coefficient Kc", "minimum": 0, "type": "number", "description": "Override crop coefficient. When set, plant_type lookup is skipped." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }