The parameters below are generally valid http request parameters for every API request. The header contains the name of the request parameter and the paragraphe below explains valid values for this parameter.
examples:
/api/v3/farms/789b88c6-eefc-11e6-b4e7-8019341382ba/settings/:
returns the L10N settings for the current farm./api/v3/farms/789b88c6-eefc-11e6-b4e7-8019341382ba/settings/?L10N=standard:
returns the standard L10N settings./api/v3/farms/789b88c6-eefc-11e6-b4e7-8019341382ba/settings/?L10N=country_eg:
returns the L10N settings for the country egypt.All crops of the Dacom platform
No fields.
All crops of the Dacom platform
Fields:
All crop varieties of the Dacom platform
No fields.
All crop varieties of the Dacom platform
Fields:
All operation types of the Dacom platform
No fields.
All operation types of the Dacom platform
Fields:
Get a fertilizer list
Args:
No fields.
Get a fertilizer list
Args:
Fields:
Get a fertilizer list
Args:
No fields.
Get a fertilizer list
Args:
Fields:
Get a chemical list
Args:
No fields.
Get a chemical list
Args:
Fields:
Get a chemical list
Args:
Fields:
Get a chemical list
Args:
No fields.
Get a chemical list
Args:
Fields:
Get a chemical list
Args:
Fields:
Get the list of additives
Args:
No fields.
Get the list of additives
Args:
Fields:
Get a chemical list
Args:
No fields.
Get a chemical list
Args:
Fields:
Get a chemical list
Args:
Fields:
Get the list of attributes
No fields.
Get the list of attributes
Fields:
Get the list of all soil types
No fields.
Get the list of all soil types
Fields:
Get the list of all soil types
No fields.
Get the list of all soil types
Fields:
Get the list of all known disease code for crops
No fields.
Get the list of all known disease code for crops
Fields:
Get the list of all known observation code
No fields.
Get the list of all known observation code
Fields:
store weather data for a sensor based on it's id.
simple code example in python to store weather data
cropr_api_client.put('/api/v3/sensors/[EXTERNAL_ID]/data/',
data=json.dumps(
{
"timestamp": "1633667263", # timestamp in UTC in seconds since 1 jan 1970.
"AT": 21.3, # Air temperature (°C)
"PT": 21.3, # Precipitation (mm)
"RAD": 331, # Radiation (J/cm²)
"RH": 80, # Relative humidity (%)
"WD": 270, # Wind direction (°)
"WS": 4, # Wind speed (m/s)
}),
content_type="application/json"
)
No fields.
returns a list of weather forecast regions viewable by the user
Optional parameters are:
lat (latitude)
lon (longitude)
If both lat and lon are specified this end point will return the data of the nearest found region at the position
of lat, lon. The json response will only contain one region but also includes the region forecast.
(See for a json example (including forecast) the example of the weather forecast detail end point.)
json list example:
{
"id": "d687552f-8b8c-43e1-b2b7-d496f294a697" # unique id of this weather forecast region
"name": "MC Hoogeveen", # name weather forecast region
"country": "NL", # country
"latitude": 52.720833, # center of gravity weather region (latitude)
"longitude": 6.478889, # center of gravity weather region (longitude)
"meta": [ # meta info about what forecasts are predicted
"air_temperature", # the air temperature in °C
"rel_humidity", # relative humidity in %
"precip_chance", # precipitation chance in %
"precipitation", # precipitation in mm
"wind_direction", # wind direction in °
"wind_speed", # wind speed in m/s
"radiation", # radiation in J/cm2
"cloud", # cloud density 1-8 (1 no clouds, 8 closed by clouds)
"weather_descriptor" # description of weather conditions
],
},
No fields.
returns a list of weather forecast predictions of <region_id>
Optional parameters are: start (epoch) timestamp to get the forecast from a timestamp until now+10 days
json list example:
{
"id": "d687552f-8b8c-43e1-b2b7-d496f294a697" # unique id of this weather forecast region
"name": "MC Hoogeveen", # name weather forecast region
"country": "NL", # country
"latitude": 52.720833, # center of gravity weather region (latitude)
"longitude": 6.478889, # center of gravity weather region (longitude)
"meta": [ # meta info about what forecasts are predicted
"air_temperature", # the air temperature in °C
"rel_humidity", # relative humidity in %
"precip_chance", # precipitation chance in %
"precipitation", # precipitation in mm
"wind_direction", # wind direction in °
"wind_speed", # wind speed in m/s
"radiation", # radiation in J/cm2
"cloud", # cloud density 1-8 (1 no clouds, 8 closed by clouds)
"weather_descriptor" # description of weather conditions
],
"forecast": [ # list of forecasts predicted for this weather region
{
"timestamp": 1487721600, # timestamp (epoch)
"values": [
9.6, # the air temperature in °C
89.0, # relative humidity in %
57.0, # precipitation chance in %
0.2, # precipitation in mm
233.0, # wind direction in °
13.9, # wind speed in m/s
0.0, # radiation in J/cm2
7.9, # cloud density 1-8
"CLOUDY"
]
},
{
"timestamp": 1487725200, # timestamp (epoch)
"values": [
10.0, # the air temperature in °C
90.0, # relative humidity in %
62.0, # precipitation chance in %
0.3, # precipitation in mm
235.0, # wind direction in °
14.6, # wind speed in m/s
0.0, # radiation in J/cm2
8.0, # cloud density 1-8
"CLOUDY_LIGHT_RAIN"
]
},
...
]
}
No fields.
returns a list of weather forecast predictions of <region_id> per 6 hours;
json list example:
{
"id": "d687552f-8b8c-43e1-b2b7-d496f294a697" # unique id of this weather forecast region
"aggregation_hours": 6, # number of hours data is aggregated of
"name": "MC Hoogeveen", # name weather forecast region
"country": "NL", # country
"latitude": 52.720833, # center of gravity weather region (latitude)
"longitude": 6.478889, # center of gravity weather region (longitude)
"meta": [ # meta info about what forecasts are predicted
"minimum_temperature", # minimum temperature in °C during 6 hrs.
"maximum_temperature", # maximum temperature in °C during 6 hrs.
"humidity", # minimum humidity in % during 6 hrs.
"precipitation_chance", # weighed maximum, average precipitation chance in % over 6 hrs.
"precipitation_amount", # precipitation sum in mm over 6 hrs.
"wind_direction", # average wind_direction in °
"wind_speed", # average windspeed in m/s over 6 hrs.
"radiation", # radiation sum in J/cm2 over 6 hrs
"cloud", # average cloud cover (0-8) over 6 hrs
"weather_descriptor" # weather descriptor
],
"forecast": [ # list of forecasts per 6 hours predicted for this weather region
{
"timestamp": 1548633600, # timestamp (epoch): start of aggregated data
"values": [
11.905, # minimum temperature in °C during 6 hrs.
14.513, # maximum temperature in °C during 6 hrs.
82.8, # minimum humidity in % during 6 hrs.
20.0, # weighed maximum, average precipitation chance in % over 6 hrs.
0.1, # precipitation sum in mm over 6 hrs.
45.0, # average wind_direction in °
1.7, # average windspeed in m/s over 6 hrs.
15.2, # radiation sum in J/cm2 over 6 hrs
1.4, # average cloud cover (0-8) over 6 hrs
"SUNNY" # weather descriptor
]
},
{
"timestamp": 1548655200, # timestamp (epoch): start of aggregated data
"values": [
17.048, # minimum temperature in °C during 6 hrs.
24.756, # maximum temperature in °C during 6 hrs.
40.9, # minimum humidity in % during 6 hrs.
50.0, # weighed maximum, average precipitation chance in % over 6 hrs.
0.3, # precipitation sum in mm over 6 hrs.
135.0, # average wind_direction in °
3.5, # average windspeed in m/s over 6 hrs.
1046.7, # radiation sum in J/cm2 over 6 hrs
5.0, # average cloud cover (0-8) over 6 hrs
"PARTLY_CLOUDY" # weather descriptor
]
},
....
]
}
No fields.
returns a list of weather forecast predictions of <region_id> per 24 hours (day);
json list example:
{
"id": "d687552f-8b8c-43e1-b2b7-d496f294a697" # unique id of this weather forecast region
"name": "MC Hoogeveen", # name weather forecast region
"aggregation_hours": 24, # number of hours data is aggregated of
"country": "NL", # country
"latitude": 52.720833, # center of gravity weather region (latitude)
"longitude": 6.478889, # center of gravity weather region (longitude)
"meta": [ # meta info about what forecasts are predicted
"minimum_temperature", # minimum temperature in °C during 24 hrs.
"maximum_temperature", # maximum temperature in °C during 24 hrs.
"humidity", # minimum humidity in % during 24 hrs.
"precipitation_chance", # weighed maximum, average precipitation chance in % over 24 hrs.
"precipitation_amount", # precipitation sum in mm over 24 hrs.
"wind_direction", # average wind_direction in °
"wind_speed", # average windspeed in m/s over 24 hrs.
"radiation", # radiation sum in J/cm2 over 24 hrs
"cloud", # average cloud cover (0-8) over 24 hrs
"weather_descriptor" # weather descriptor
],
"forecast": [ # list of forecasts per 24 hours predicted for this weather region
{
"timestamp": 1548633600, # timestamp (epoch): start of aggregated data
"values": [
11.905, # minimum temperature in °C during 24 hrs.
26.641, # maximum temperature in °C during 24 hrs.
36.5, # minimum humidity in % during 24 hrs.
70.0, # weighed maximum, average precipitation chance in % over 24 hrs.
3.1, # precipitation sum in mm over 24 hrs.
90.0, # average wind_direction in °
3.2, # average windspeed in m/s over 24 hrs.
1793.7, # radiation sum in J/cm2 over 24 hrs
0.0, # average cloud cover (0-8) over 24 hrs
"PARTLY_CLOUDY_LIGHT_RAIN" # weather descriptor
]
},
{
"timestamp": 1548655200, # timestamp (epoch): start of aggregated data
"values": [
12.358, # minimum temperature in °C during 24 hrs.
31.845, # maximum temperature in °C during 24 hrs.
16.2, # minimum humidity in % during 24 hrs.
50.0, # weighed maximum, average precipitation chance in % over 24 hrs.
1.7, # precipitation sum in mm over 24 hrs.
45.0, # average wind_direction in °
3.7, # average windspeed in m/s over 24 hrs.
2043.7, # radiation sum in J/cm2 over 24 hrs
3.6, # average cloud cover (0-8) over 24 hrs
"PARTLY_CLOUDY_LIGHT_RAIN" # weather descriptor
]
},
....
]
}
No fields.
returns a list of weather forecast ET0 predictions of <region_id> per 24 hours (day);
json list example:
{
"id": "d687552f-8b8c-43e1-b2b7-d496f294a697" # unique id of this weather forecast region
"name": "MC Hoogeveen", # name weather forecast region
"aggregation_hours": 24, # number of hours data is aggregated of
"country": "NL", # country
"latitude": 52.720833, # center of gravity weather region (latitude)
"longitude": 6.478889, # center of gravity weather region (longitude)
"forecast": [ # list of forecasts per 24 hours predicted for this weather region
{
"timestamp": 1548633600, # timestamp (epoch): start of aggregated data
"et0": 0.7 # et0 in mm of current day
},
{
"timestamp": 1548655200, # timestamp (epoch): start of aggregated data
"et0": 0.48 # et0 in mm of current day
},
....
]
}
No fields.
returns a list of owned sensor installations: soil moisture stations and weather stations
json list example:
{
"id": "2242a8a3-4b8c-4ea5-b895-c4f1c4b6daa7", # unique id of this sensor installation
"installed_on_farm_id": "23f9-321f-a3d2-cdb39" # farm_id used this to retrieve sensor the data for this shared sensor.
"name": "UK Agrii Alton", # name of this sensor installation
"view_settings_name": "UK Agrii Alton", # name of the view settings of this installation
"serial_number": "57242", # serial number of sensor installation
"active_period_start": 1460073600, # timestamp (epoch) when this sensor installation was activated
"active_period_end": null, # timestamp (epoch) until when this sensor installation was active
"powered_on": true, # 'true' if the sensor installation is powered on
"is_weather_station": false, # 'true' if the sensor is a weather station
"is_soil_moisture_station": false, # 'true' if the sensor is a soil moisture station
"is_precipitation_station": true, # 'true' if the sensor is a precipitation station
"has_recent_measurements": true, # 'true' if this sensor installation has recent measurements
"latitude": 51.079167, # location sensor installation (latitude)
"longitude": -1.026111, # location sensor installation (longitude)
"meta": [ # meta info about the sensor installation measurements
{
"unit": "°C",
"key": "air_temperature" # the air temperature in °C
},
{
"unit": "%",
"key": "rel_humidity" # relative humidity in %
},
{
"unit": "mm",
"key": "precipitation" # precipitation in mm
},
{
"unit": "m/s",
"key": "wind_speed" # wind speed in m/s
},
{
"unit": "°",
"key": "wind_direction" # wind direction in °
},
{
"unit": "J/cm²",
"key": "radiation" # radiation in J/cm2
},
{
"unit": "°C",
"key": "soil_temperature" # the soil temperature in °C
}
]
},
{
"id": "913f1a79-42e0-44a8-997b-22cdbeec08bb", # unique id of this sensor installation
"name": "1012", # name of this sensor installation
"serial_number": "0000001012", # serial number of sensor installation
"active_period_start": 1454284800, # timestamp (epoch) when this sensor installation was activated
"active_period_end": 1514678400, # timestamp (epoch) until when this sensor installation was active
"powered_on": true, # 'true' if the sensor installation is powered on
"has_recent_measurements": true, # 'true' if this sensor installation has recent measurements
"latitude": 52.77261, # location sensor installation (latitude)
"longitude": 6.80483, # location sensor installation (longitude)
"meta": [ # meta info about the sensor installation measurements
{
"unit": "mm",
"key": "moisture_level__depths__10" # the soil moisture level at 10 cm depth
},
{
"unit": "mm",
"key": "moisture_level__depths__20" # the soil moisture level at 20 cm depth
},
{
"unit": "°C",
"key": "soil_temperature__depths__10" # the soil temperature in °C at 10 cm depth
},
{
"unit": "°C",
"key": "soil_temperature__depths__20" # the soil temperature in °C at 20 cm depth
}
]
}
No fields.
returns a list of raw measurements measured by installation_id
Optional parameters are: start (epoch) timestamp to get the measurements from a timestamp end (epoch) timestamp to get the measurements until a timestamp days (int) to get a number of days (always from now)
json list example:
{
"id": "913f1a79-42e0-44a8-997b-22cdbeec08bb", # unique id of this sensor installation
"name": "1012", # name of this sensor installation
"serial_number": "0000001012", # serial number of sensor installation
"active_period_start": 1454284800, # timestamp (epoch) when this sensor installation was activated
"active_period_end": 1514678400, # timestamp (epoch) until when this sensor installation was active
"powered_on": true, # 'true' if the sensor installation is powered on
"has_recent_measurements": true, # 'true' if this sensor installation has recent measurements
"latitude": 52.77261, # location sensor installation (latitude)
"longitude": 6.80483, # location sensor installation (longitude)
"meta": [ # meta info about the sensor installation measurements
{
"unit": "dacom",
"key": "moisture_level__depths__10" # the soil moisture level at 10 cm depth
},
{
"unit": "dacom",
"key": "moisture_level__depths__20" # the soil moisture level at 20 cm depth
},
{
"unit": "°C",
"key": "soil_temperature__depths__10" # the soil temperature in °C at 10 cm depth
},
{
"unit": "°C",
"key": "soil_temperature__depths__20" # the soil temperature in °C at 20 cm depth
}
],
"raw_measurements": [ # list of measurements by this station
{
"timestamp": 1484958600, # timestamp of the measurement (epoch)
"values": [
71.78, # the soil moisture level at 10 cm depth
85.18, # the soil moisture level at 20 cm depth
12.02, # the soil temperature in °C at 10 cm depth
12.33 # the soil temperature in °C at 20 cm depth
]
},
{
"timestamp": 1484960400, # timestamp of the measurement (epoch)
"values": [
71.78, # the soil moisture level at 10 cm depth
85.18, # the soil moisture level at 20 cm depth
12.13, # the soil temperature in °C at 10 cm depth
12.33 # the soil temperature in °C at 20 cm depth
]
},
{
"timestamp": 1484962200, # timestamp of the measurement (epoch)
"values": [
71.84, # the soil moisture level at 10 cm depth
85.18, # the soil moisture level at 20 cm depth
12.07, # the soil temperature in °C at 10 cm depth
12.33 # the soil temperature in °C at 20 cm depth
]
},
...
]
}
No fields.
returns a list of internal technical details (energy consumption, signal quality) measured by installation_id
json list example:
{
"id": "913f1a79-42e0-44a8-997b-22cdbeec08bb", # unique id of this sensor installation
"name": "1012", # name of this sensor installation
"serial_number": "0000001012", # serial number of sensor installation
"active_period_start": 1454284800, # timestamp (epoch) when this sensor installation was activated
"active_period_end": 1514678400, # timestamp (epoch) until when this sensor installation was active
"powered_on": true, # 'true' if the sensor installation is powered on
"has_recent_measurements": true, # 'true' if this sensor installation has recent measurements
"latitude": 52.77261, # location sensor installation (latitude)
"longitude": 6.80483, # location sensor installation (longitude)
"tech_meta": [ # meta info about the sensor technical details
"voltage", # battery voltage
"csq", # RF signal quality
"sim", # SIM card number
"reset", # True if sensor was reset
"fw_version" # Firmware version
],
"tech": [ # list of technical details measurements
{
"timestamp": 1487724300, # timestamp of the technical details measurement (epoch)
"values": [
"4.15", # battery voltage (V)
"18", # RF signal quality
"8933012360300653266", # SIM card number
"False", # True if sensor was reset
"V6.12.001_RevE_USB" # Firmware version
]
},
...
]
}
Optional parameters are: start (epoch) timestamp to get the technical details measurements from a timestamp end (epoch) timestamp to get the technical details measurements until a timestamp days (int) to get a number of days (always from now)
No fields.
returns a list of interpreted measurements measured by installation_id based on the settings made by the user
json list example:
{
"id": "913f1a79-42e0-44a8-997b-22cdbeec08bb", # unique id of this sensor installation
"name": "1012", # name of this sensor installation
"serial_number": "0000001012", # serial number of sensor installation
"active_period_start": 1454284800, # timestamp (epoch) when this sensor installation was activated
"active_period_end": 1514678400, # timestamp (epoch) until when this sensor installation was active
"powered_on": true, # 'true' if the sensor installation is powered on
"has_recent_measurements": true, # 'true' if this sensor installation has recent measurements
"latitude": 52.77261, # location sensor installation (latitude)
"longitude": 6.80483, # location sensor installation (longitude)
"meta": [ # meta info about the sensor installation measurements
{
"unit": "mm",
"key": "moisture_level__depths__10" # the soil moisture level at 10 cm depth in mm
},
{
"unit": "mm",
"key": "moisture_level__depths__20" # the soil moisture level at 20 cm depth in mm
},
{
"unit": "°C",
"key": "soil_temperature__depths__10" # the soil temperature in °C at 10 cm depth
},
{
"unit": "°C",
"key": "soil_temperature__depths__20" # the soil temperature in °C at 20 cm depth
}
],
"raw_measurements": [ # list of measurements by this station
{
"timestamp": 1484958600, # timestamp of the measurement (epoch)
"values": [
7.78, # the soil moisture level at 10 cm depth in mm
8.18, # the soil moisture level at 20 cm depth in mm
12.02, # the soil temperature in °C at 10 cm depth
12.33 # the soil temperature in °C at 20 cm depth
]
},
{
"timestamp": 1484960400, # timestamp of the measurement (epoch)
"values": [
7.78, # the soil moisture level at 10 cm depth in mm
8.18, # the soil moisture level at 20 cm depth in mm
12.13, # the soil temperature in °C at 10 cm depth
12.33 # the soil temperature in °C at 20 cm depth
]
},
{
"timestamp": 1484962200, # timestamp of the measurement (epoch)
"values": [
7.84, # the soil moisture level at 10 cm depth in mm
8.19, # the soil moisture level at 20 cm depth in mm
12.07, # the soil temperature in °C at 10 cm depth
12.33 # the soil temperature in °C at 20 cm depth
]
},
...
]
}
Optional parameters are:
start (epoch) timestamp to get the measurements from a timestamp
end (epoch) timestamp to get the measurements until a timestamp
days (int) to get a number of days (always from now)
No fields.
returns the installation id and the name of the actual view settings
json list example:
{
"installation_id": "913f1a79-42e0-44a8-997b-22cdbeec08bb", # unique id of this sensor installation
"name": "1012 view settings", # name of this installation view settings
}
No fields.
returns EWS URLs for all allowed EWS regions and diseases
EWS discover example response:
{
"REGION_NAME": {
"CROP_CODE": {
"urls": [
"https://sfam.crop-r.com/ews/tile/REGION_NAME/2021/4/29/FUNGUS_CODE/{z}/{x}/{y}.png?key=SECRET_KEY"
]
}
}
}
No fields.
API end point, which returns the EWS value for a given point (lat, lng) within a region.
required request parameters:
Example request: https://sfam.crop-r.com/api/V1/ews/PHYTOPHTHORA_CROP_TOMATO/?lat=52.3&lng=6.3®ion=NL the response will look something like this. The infection chances are in percentages (0% - 100%). To have an indication of what these percentages mean > 50% Infection risk is high 50% - 35% Infection risk is moderate < 35% Infection risk is low
{
"fungus": "PHYTOPHTHORA_CROP_TOMATO",
"location": {
"lat": 52.3,
"lng": 6.3
},
"infection_chances": {
"2021-05-12": 15, // infection chance in percent (0% - 100%)
"2021-05-13": 8,
"2021-05-14": 3,
"2021-05-15": 5,
"2021-05-16": null, // there no infection chance calculated.
}
}
No fields.
No fields.
Creates a new user, requires a valid application_id
Fields:
Fields:
Get farm data. Without parameter (/farms/), it shows the list of farms this account has access to with a limited set of attributes.
If a specific farm is requested (/farms/
optional request parameters for filtering are:
No fields.
Get farm data. Without parameter (/farms/), it shows the list of farms this account has access to with a limited set of attributes.
If a specific farm is requested (/farms/
optional request parameters for filtering are:
Fields:
Retrieve the features I would get as a user on this farm. The active features are a merged set of the active subscription, the installed applications and special user roles like SuperUser
returns: a dictionary of features
{
"export_shape": "True",
"add_farm_contact": "True",
"custom_resources": "True",
"mobile_app": "True",
"admissions": "True",
"maximum_area": "300",
"pro": "True",
"maximum_records": "3000",
"bulk": "True",
"record_switch_view": "True",
"job": "True",
"planning": "True",
"allowed_users": "5",
"inventory": "True",
"basic": "True",
"report": "True",
"soil_data": "True",
"brp_history": "True",
"configuration": "True"
}
Fields:
Retrieve the active order of the farm.
returns:
{
"period_end,": "2018-03-31",
"active_until,": "2018-03-31",
"subscription_name": "Pro",
"period_start,": "2017-03-31",
"provided_features": {
"export_shape": "True",
"add_farm_contact": "True",
"custom_resources": "True",
"mobile_app": "True",
"admissions": "True",
"maximum_area": "300",
"pro": "True",
"maximum_records": "3000",
"bulk": "True",
"record_switch_view": "True",
"job": "True",
"planning": "True",
"allowed_users": "5",
"inventory": "True",
"basic": "True",
"report": "True",
"soil_data": "True",
"brp_history": "True",
"configuration": "True"
}
"product_gids": ["crop_recording", "cloudfarm"]
}
Fields:
Retrieve the custom coding_lists on a farm.
returns:
{
"operation_types": [ // list of custom made operation type on this farm
// see '/api/v3/coding_lists/operation_types/' how it is represented in json
],
"fertilizers": [ // list of custom made fertilizers on this farm
// see also '/api/v3/coding_lists/fertilizers/' how it is represented in json
]
}
Fields:
Retrieve the configuration of the farm.
returns:
{
"diseases": [ // list of configured disease_codes on this farm
// see '/api/v3/coding_lists/disease_codes/' how it is represented in json
],
}
Fields:
Get farm data. Without parameter (/farms/), it shows the list of farms this account has access to with a limited set of attributes.
If a specific farm is requested (/farms/
optional request parameters for filtering are:
Fields:
Post or Get new event to the farm upon which the application can act.
parameters:
Fields:
returns:
{
"chemical_list": [ // a list of used chemical lists on this farm
"International", // the international chemical list
],
"fertilizer_list": [ // a list of used fertilizer lists on this farm
"International", // the international fertilizer list
"nl", // the dutch fertilizer list
],
"l10n": { // localization settings of this farm
"unit_area": "ha", // unit of area (e.g 'ha', 'acre', 'm2' (square meter)
"unit_distance": "m",
"unit_mass": "kg",
"unit_temp": "C",
"unit_volume": "liter",
"unit_currency": "EUR"
"unit_precipitation": "mm"
"unit_windspeed": "mps"
}
}
Fields:
Retrieve the features i would get as a user on this farm, including permissions which are no longer active. The period features are a merged set of the active subscription, the installed applications, and special user roles like SuperUser. If available, each feature has a start date and end date when the feature was active. For b&b subscriptions this endpoint tries to determine if de subscription is a trial.
returns: a dictionary of features with the period in which the feature is active
{
"dacom_online_disease": {
"value": true,
"periodStart": "2021-08-24",
"periodEnd": "2031-09-24",
"active": true
},
"bbnl_pro": {
"value": true,
"periodStart": "2021-07-24",
"periodEnd": "2031-08-25",
"active": false,
"trial": true
},
"sensetion": {
"periodStart": "",
"periodEnd": "",
"active": true
}
}
Fields:
Get farm data. Without parameter (/farms/), it shows the list of farms this account has access to with a limited set of attributes.
If a specific farm is requested (/farms/
optional request parameters for filtering are:
No fields.
Get farm data. Without parameter (/farms/), it shows the list of farms this account has access to with a limited set of attributes.
If a specific farm is requested (/farms/
optional request parameters for filtering are:
Fields:
Get token to access other applications
parameters:
Fields:
Get cropping schemes
No fields.
Get cropping schemes
Fields:
Get the financial balance of the requested cropping scheme
Fields:
No fields.
Fields:
No fields.
Fields:
Fields:
Reference imports are sets of farm-imported geometries, like shapefiles.
No fields.
Reference imports are sets of farm-imported geometries, like shapefiles.
Fields:
Get contacts for farm
No fields.
Get contacts for farm
Fields:
No fields.
Fields:
No fields.
Fields:
Fields:
Fields:
Fields:
No fields.
Fields:
Fields:
returns the centroid if the crop field:
{
"centroid": [
7.148085688312003, // x coordinate (longitude)
53.22557800646526 // y coordinate (latitude)
]
}
Fields:
No fields.
Fields:
No fields.
Fields:
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of jobs and create a job from multiple tasks
When creating a new job, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a jon.
# With a list of machine ids | uuids
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/jobs/',
data=json.dumps({"name": "name of job", "tasks": [1, 2, 3, ...] | ["b123-234", ...], }),
content_type="application/json"
)
optional request parameters for filtering are:
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of tasks or to create new tasks.
When creating a new task, data must be sent in json format and the content_type of the put request must be "application/json"
simple code example to create a task.
cropr_api_client.post('/api/v3/farms/[FARM_ID]/cropping_schemes/[CROPPING_SCHEME_ID]/crop_fields/[FIELD_ID]/tasks/',
data=json.dumps({"date": "2016-11-11T16:41:00", "operations": [{"edi_code": "504003", }], }),
content_type="application/json"
)
example of more complex json data for creating a task:
{
"id": "06af0aac-cf96-4a17-84ff-4b9027568", # unique id for this task.
"date": "2016-11-11T16:41:00", # when task was performed
"duration": "01:11:00", # duration of de task (1 hour and 11 minutes)
"treatment_zone": { # treament zone of the task (if not specified whole cropfield is assumed)
"unit": "ha", # unit of area
"value": 10.8 # area
},
"operations": [ # list of operations in this task
{
"code": "80300", # operation edi code (Row spraying)
"batches": [ # batches used for this operation
{
"batch_id": "b123-234", # unique batch-id
"value": 1.125, # amount of product applied
"unit": "l/ha", # dosage unit
"product_name": "Finale", # Name describing the product
}
],
"attributes": [ # operation attributes
{
"id": "8c409808-eefc-..." # safety term attribute
"value": 14.0, # value of safety term (in days)
}
],
}
],
"machines": ["b123-234", ...], # list of machine ids | uuids
"labels": ["b123-234", ...] | ["a", "b", ...], # list of label ids | uuids | names
"coworkers" : ["b123-234", ...] | ["a", "b", ...], # list of coworkers ids | uuids | names
"notes": "Destroy Herbicides" # extra notes for this task.
}
optional request parameters for filtering are:
{
"date": "2016-11-11T16:41:00", # when task was performed
...
"actions": {
'SEND_CONTRACTOR_SELECTOR_INVITATION': {
"external_id": "customer_nr_1", # a customer external id
"order_nr": "your own order number", # an order number for the contractor selector invitation
}
}
}
No fields.
Endpoint to get a list of observations.
No fields.
No fields.