Picture
Picture

Documentation

Prerequisite

Some actions are needed in order to start using Smag Link APIs which are not described in this section.

Please go to the Get Started section.

FarmsAndFields

Which data can be accessed ?

This API has been designed to retrieve information about :

  • farms

  • fields

  • crop zones

Example Use Case : I want to get all the crop zones for a farm

STEP 1 : Retrieve all the farms associated with a token

Use the "get a farm list" endpoint in order to get the complete list of farms for a given token.

https://api.smag.tech/farmsandfields/v1/farms[?farmCode][&cropYear]

The response will be a farm list.

In each farm, you will find informations about this farm and an "uid" attribute.

Picture
Picture

STEP 2 : Get the crop zone list for a farm

Use the "get a crop zone list" endpoint with the farmUid you got on STEP 1.

https://api.smag.tech/farmsandfields/v1/farms/{farmUid}/cropZones[?cropYear]

Picture
Picture
Go to top

Crops

Which data can be accessed

This API has been designed to retrieve informations about :

  • Crops

  • Varieties

  • Vegetative stages

Example Use Case : I want to get the crop for a crop zone

STEP 1 : Get a crop zone / a crop zone list

See the FarmsAndFields section.

In the crop resource, you will find a "cropUid" attribute.

STEP 2 : Get the crop

Use the "get a crop" endpoint to get detailled information about the crop

https://api.smag.tech/crop/v1/crops/{cropUid}

Picture
Picture