The API-Scope
The API uses REST services, OAuth2, and employs a JSON data format.
Each data point in the received JSON format provides information relating to a single GPS point and timestamp. Due to the large amounts of data a machine generates over time, the API supports queries with the following restrictions and responses:
- Short time period – within an interval from 5 minutes up to 1 hour: the values for this request are returned directly in the call response.
- Long time period – within an interval from 1 hour up to 31 days: the values are collected in the background and made available as a compressed archive for retrieval.
The main use cases are:
- Requesting a machine list of a customer organization.
- Retrieving telemetry data for performance documentation of the machine.
- Retrieving telemetry data for agronomic documentation of the machine.
- Requesting data for a specific machine and dataset using a time period.
- Requesting data for a specific machine and dataset using a GPS filter.
- Requesting data for a specific machine and dataset using both a time period and a GPS filter.
Contact
To use the services, third-party providers must be official partners of CLAAS, as our API scopes are restrictedly accessible and not completely public. To become an official partner, you can contact us here.
