You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
Wilco Krikke 49f9418bc5 Update 'Blight-API.md' 1 year ago
examples updated workflow and component pages, restructure index 3 years ago
.gitignore fixed links 3 years ago
Authentication.md Update 'Authentication.md' 1 year ago
Blight-API.md Update 'Blight-API.md' 1 year ago
Create-Cropfield.md Update page 'Create Cropfield' 3 years ago
Create-Croppingscheme.md Added croppinscheme step 1 year ago
Create-Taskmap.md Update 'Create-Taskmap.md' 2 years ago
Create-a-cropfield.md Add Running tasks article and various corrections 3 years ago
Create-access-token.md Adding authentication articles 3 years ago
Create-b-cropfield.md Update 'Create-b-cropfield.md' 1 year ago
FarmMapsLibs.md Update page 'FarmMapsLibs' 3 years ago
Integrating-FarmMaps-OIDC.md Fixing broken link, adding notes to Integrating IODC 3 years ago
Main-components.md fixed links 3 years ago
Message-Queue-Endpoint.md updated workflow and component pages, restructure index 3 years ago
Polling-task-status.md Update 'Polling-task-status.md' 3 years ago
README.md Update 'README.md' 2 years ago
Running-tasks.md fixed links 3 years ago
Shape-to-geotiff.md Update 'Shape-to-geotiff.md' 2 years ago
Upload-Data.md Update page 'Upload Data' 3 years ago
Upload-a-file.md fixed links 3 years ago
VRAHaulmkilling-API.md Update 'VRAHaulmkilling-API.md' 2 years ago
VRAHerbicide-API.md Update 'VRAHerbicide-API.md' 2 years ago
VRANbs-API.md Update 'VRANbs-API.md' 2 years ago
VRAPoten-API.md Update 'VRAPoten-API.md' 2 years ago
Workflow.md updated workflow and component pages, restructure index 3 years ago

README.md

Farmmaps Documentation Overview

The documentation is still work in progress and heavily subject to change!

This page provides an index of the available documentation for the FarmMaps platform.

Getting started

The main starting point for Farmmaps API access is the REST API. To get started, follow the steps below.
The workflow and high-level architecture FarmMaps are documented on the Farmmaps Workflow and FarmMaps Main Components pages.

Environments

At the moment, FarmMaps provides two environments for development.

When developing your application, using the acceptation environment is highly recommended.

Obtaining credentials

To get access to the API, you need an akkerweb development account (akkerweb development and farmmaps development use the same credentials). These can be created at:

It is also possible to get credentials to use the cleint credential flow, please contact FarmMaps for further information.

Once you have an account, you can create a JSON Web Token to authenticate at the API endpoint.

Authentication & Authorization flow

FarmMaps uses Open ID Connect to provide user authentication and authorization services. Open ID Connect (and OAuth beneath the surface) allows your application to access user information or data that is located at another service, without providing you the password to access the account. This is very useful if your application relies on data that needs to provided by this other service for your application to work.

So, in the authentication flow there are two parties:

  • The OpenID Provider (OP), holding the accounts database and providing the authentication services.
  • The Relying Party (RP), relying on authentication through the OP, to get access to the required data or endpoints.

The general flow (for FarmMaps) is as follows:

  • The user is at your application
  • Your application needs to access the farmmaps account of that user (i.e. to upload, modify or retrieve data)
  • Your application creates an authentication request for the Open ID Provider.
  • The user is redirected to the "Log in page" of the OpenID Provider.
  • The user logs in at the login page.
  • On succesfull login, the user is redirected back to your application and the OpenID Provider returns an access token.

Now that the user is back at your application and the application has an access token, it can then request resources from the OpenID provider. For each request, the access token needs to be sent along. This access token provides proof that the person sending the request is allowed to access the request and is who he/she claims to be. FarmMaps uses JWT as the format for the access token.

To continue please see one of the articles below:

Using the FarmMaps API

Once you have an access token, you can start querying the API.
A reference of the API can be found on the swagger page The API basics are uploading files, creating items and and running tasks to modify or convert data. For testing purposes, Postman can be used to perform HTTP requests more easily.

We provide the following guides:

Generally, tasks can be run in the same way. However, each specific task has it's own inputs and properties. How these work can be found in the use task examples below.

Task examples