Getting Started

Introduction

Our APIs are designed to help you build applications that integrate with Bloomeo’s services. This guide will walk you through the process of getting started with our APIs, from setting up your account to making your first API call.

Prerequisites

Before you can start using our APIs, you’ll need to create an account and contact your account manager to get your account created.

Note

Currently, only personal tokens are available to interact with our APIs, and they have a validity period of one hour.

Getting Started

  1. Obtain Your Personal Token
    1. Log in to the Bloomeo web application.
    2. Click on your profile (top right).
    3. Click 5 times on your initials to active the “expert mode” and to reveal the “Copy access token” button. expert-mode expert-mode
    4. Click on “Copy access token”. The token will be copied to your clipboard. api-core api-core
  2. Make Your First API Call
    1. Refer to the API Reference and select the API you want to interact with.
      Quick search

      Do not hesitate to search for the term you are looking for using your browser search feature (Ctrl + F) to find quickly, in the mind map, the domain holding the API you are looking for. mindmap mindmap

    2. On the specific API page, click on the “Authorize” button. api-core api-core
    3. Paste your token into the displayed modal and click “Authorize”. auth-token auth-token
    4. Click on the “Try it out” button. try try
    5. Execute the API call by clicking on “Execute”. execute execute

Next Steps

  1. Set the core entities in Bloomeo. Refer to the Core Entities section.
  2. Start managing your common entities:
    1. Variables
    2. Genotypes or Products
    3. Growing Areas
    4. Market Segments
  3. Plan your first experiment. Refer to the Experimentation section.