Webservices in TEMPO data portal

The TEMPO data portal provides a set of web services that allow users to access data stored in the portal. These web services are designed to be easy to use and integrate with other systems.

They are provided as RESTful services.

Usage

The web services are available without any authentication. Consequently, only public data can be accessed.

OpenAPI Specification

The full set of web services for the TEMPO data portal is auto-described using the OpenAPI specification at openapi/openapi.json.

The Swagger UI is used to explore and test the web services. It provides an interface to interact with the web services and understand their behavior. The interface shows the documentation written in the OpenAPI format, including their endpoints, parameters, and response schemas. Interacting with the interface provides the Curl command, the HTTP request, and the response, making it easy to integrate with other systems.

Expand the details for an endpoint using the arrow down icon to get:

• list and description of parameters,
• accepted media types,
• Try it out button to interact with the endpoint,
• example value and data schema for the response,
• real response after using the Try it out button.

Technical description of web services

The TEMPO data portal provides 15 endpoints for data, metadata and utility.

Data:

• /pheno/additionaldata
• /pheno/cache

Metadata:

• /pheno/contact
• /pheno/source
• /pheno/license
• /pheno/site
• /pheno/site/commune
• /pheno/site/country
• /pheno/site/department
• /pheno/site/region
• /pheno/stage
• /pheno/stage/mainevent
• /pheno/taxon
• /pheno/taxon/children

Utility:

• /pheno/ping

All responses are in JSON format and follow the generic structure:

{
  "pagination": {
    "firstCursor": 0,
    "lastCursor": 0,
    "pageSize": 0,
    "totalCount": 0
  },
  "status": {
    "code": 0,
    "message": "string"
  },
  "data": [
    {
      "someattribute": "somevalue"
    }
  ]
}

Pagination is used to serve 15,000 values. The maximum number of values per response can be changed using the parameter pageSize (maximum 200,000 values). To get the following value, get the lastCursor value of the last response as parameter value for cursor for the next query.

External usages of the web services

The web services of TEMPO data portal are used since May 2025 by PEP725 (Pan European Phenology Project) to get data for some data sources.