In this post we are going to talk about integration with Stara starting from creating a developer account to registering the credentials to a user. All endpoints can be found in our docs and Postman collection.
(Clique aqui para a tradução em português)
Summary
- Step 0: Create a developer account with Stara
- Step 1: Get your API Key from Stara
- Step 2: Get your tokens from Stara
- Step 3: Add Stara credentials to Leaf
Keep in mind that this tutorial is a full walkthrough. Most of the steps presented will be done only once, meaning that subsequent calls will be much easier and faster.
Step 0: Create A Developer Account With Stara
(If you already have a developer account in Stara, you can skip this step.)
Contact Stara to request access to their API through their email: servicos@stara.com.br; or phone number: +55 054 99706-7292. You will receive a username and password.
Once you have those, you can go to the next step of this tutorial.
Step 1: Get Your API Key From Stara
Go to Stara developer’s login page at https://developers.stara.com.br/login and use your username and password to log in.
Once logged in, your API Key will be displayed in the green field shown in the image below.
With this Key you are able to start using the Stara API. Now we’re ready for the next step.
Step 2: Get Your Tokens From Stara
For this step you will need:
- username
- password
- API Key
To get your credential tokens, a POST request can be made to the following endpoint:
https://v2apitelemetria.telemetriastara.com.br/autenticacao_user
The request body must include the three attributes previously mentioned:
The tokens can be retrieved in the response of this request:
If you prefer you can use our postman collection to make these calls.
With these tokens, we can proceed to the next step.
Step 3: Add Stara Credentials to Leaf
Leaf’s API uses an abstraction called Leaf User to store credentials and organize data for each individual data owner. In most cases, the Leaf User will be the farmer or consultant that has access to the source data inside the machinery company’s FMIS (e.g. Stara Telemetry).
To send your credentials to Leaf, you will need your access token from Leaf, and have already created a Leaf User. If you don’t know how to do that,
Now, attach your credentials to the Leaf User you created. Send a POST to:
https://api.withleaf.io/services/usermanagement/api/users/%7ByourLeafUserId%7D/stara-credentials
with the following Header:
and with the following JSON:
Excellent!
Now Leaf will start fetching your farm data from Stara. You can now query Leaf for your standardized data.
Software developers use Leaf’s API to build and scale a wide range of products including farm optimization tools, lending products, outcome-based financing, land and input marketplaces, agronomic recommendations, traceability applications, equipment maintenance forecasting, and more.
