/getting-started/index.htmlIntroduction 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 You can use personal tokens (valid for one hour) or application accounts for server-to-server integrations. See Application Accounts for the client credentials flow.Hugoen-us/getting-started/core-entities/index.htmlMon, 01 Jan 0001 00:00:00 +0000/getting-started/core-entities/index.htmlSome entities are shared across different domains in Bloomeo. These entities enable fine-grained access control and ensure data consistency. This section describes these entities and how to interact with them. Geography, Organization, and Species Hierarchies Geography, Organization, and Species hierarchies organize and determine the scope of all data in Bloomeo. They control data access and facilitate filtering and pre-population of data in forms. Setting up hierarchies is a structural task that should be done by a Bloomeo administrator. Once created, items in a hierarchy cannot be updated or deleted. If changes are needed, create a new item and mark the old one as deprecated./getting-started/application-accounts/index.htmlMon, 01 Jan 0001 00:00:00 +0000/getting-started/application-accounts/index.htmlOverview Application accounts (service accounts) let you run server-to-server workflows with OAuth 2.0 client credentials. Tokens issued for these accounts carry the role and ABAC scopes configured when the account was created, so they enforce the same permissions as user tokens. Prerequisites Access to the Bloomeo web app and the permissions to create application accounts. The application account’s clientId and clientSecret. The secret is only shown once when you create the account. The Cognito domain for your environment (for example app.auth.eu-west-3.amazoncognito.com). The API host you will call (for example api.app.bloomeo-app.com). Scope: bloomeo-services/all. Create an application account In the Bloomeo web app, open Configuration → Users → Application accounts. Click Create application account, fill the name/description, pick the role, and choose the ABAC toggles you need. After creation, copy the clientId and clientSecret. Store them securely (password manager, secret store). If the secret is lost, delete the account and create a new one to rotate credentials. Warning Keep the client secret private. Tokens minted with the secret inherit the permissions of the associated role./getting-started/first-trial/index.htmlMon, 01 Jan 0001 00:00:00 +0000/getting-started/first-trial/index.htmlIntroduction A trial is an experiment involving one or several factors (Genotypes, Products, etc.) in a specific environment (Growing Area) to evaluate certain traits (Variables). This guide will walk you through the process of creating your first trial in Bloomeo. Prerequisites Before creating trials, ensure you have the following: A minimal set of hierarchies (Geography, Organization, and Species). See Core Entities for more details. A set of genotypes or products to test. See Germplasm for more details. (Optional) A growing area to define the environment of your trial. See Growing Area for more details. Create Your First Trial Use the POST /trial endpoint of the experiment service to create a trial./getting-started/cube/index.htmlMon, 01 Jan 0001 00:00:00 +0000/getting-started/cube/index.htmlIntroduction In addition to HTTP REST APIs, Bloomeo provides a SQL interface. The SQL API enables delivering data over the Postgres-compatible protocol to a wide range of data visualization tools. In general, if an application connects to PostgreSQL database, it can connect to this interface as well. This feature is currently in alpha and may be subject to changes. Prerequisites To use the SQL interface, you need: A Bloomeo account with access to the SQL interface feature. Basic knowledge of SQL syntax and commands. An up-to-date JWT token for authentication (see Authentication for more details). Make your first query To execute SQL queries against the Bloomeo SQL interface, follow these steps: