Base URL
Authentication
No authentication is required. All endpoints are publicly accessible.Request and response format
All request bodies must be JSON (Content-Type: application/json). All responses are JSON except for the chart export endpoint, which returns a PNG image (image/png).
Error format
Errors are returned as JSON objects with adetail field:
HTTP status codes
| Code | Meaning |
|---|---|
200 OK | Request succeeded |
400 Bad Request | Invalid ObjectId format or business logic validation failure |
404 Not Found | Requested resource does not exist |
422 Unprocessable Entity | Request body failed schema validation (FastAPI default) |
Pagination
List endpoints acceptskip and limit query parameters for cursor-based pagination.
| Parameter | Type | Description |
|---|---|---|
skip | integer | Number of records to skip. Minimum: 0. Default: 0. |
limit | integer | Maximum records to return. Default: 10. |
limit value differs by resource:
- Indicators: max
50 - Search: max
20 - Data segments: max
10000
Resource groups
Indicators
Create, read, update, delete, and search tourism indicators. Core resource of the service.
Domains
Manage domains and subdomains that categorize indicators.
Data & Statistics
Upload and query time-series data segments associated with indicators.
Annotations
Attach annotations to data points for context and commentary.
Export
Export indicator charts as PNG images with configurable styling.
Health
Service version and health check endpoints.
ObjectId format
Allid fields and ID parameters use MongoDB ObjectId strings — 24-character lowercase hexadecimal strings.
400 Bad Request.