Welcome to our API documentation. This guide provides information about the available APIs, their endpoints, and how to use them. All APIs require authentication via an API key.
X-API-Key
header.
We provide interactive API documentation using Swagger and ReDoc:
APIs for creating, retrieving, and managing geometries (polygons).
GET
/api/geometry/ - List all geometries
POST
/api/geometry/ - Create a new geometry
GET
/api/geometry/{id}/ - Get a specific geometry
APIs for searching, analyzing, and retrieving Sentinel-2 satellite imagery.
POST
/api/s2/search/ - Search for available imagery
POST
/api/s2/stats/ - Get statistics for imagery
GET
/api/s2/image/{id}/ - Get imagery for a geometry
APIs for retrieving current, forecast, and historical weather data.
GET
/api/weather/current/ - Current weather
GET
/api/weather/today/ - Today's weather
GET
/api/weather/forecast/ - Weather forecast
GET
/api/weather/historical/ - Historical weather
APIs for retrieving elevation data and contour lines.
GET
/api/dem/ - Get elevation data
GET
/api/contours/ - Get contour lines
All API endpoints require authentication using an API key. Include your API key in the request headers:
X-API-Key: your-api-key-here
All API responses are in JSON format, except for image endpoints which return binary data.
Error responses include an HTTP status code and a JSON object with an error message:
{
"error": "Error message description"
}