Data API Overview

The Preventos Data API gives authorized third-party integrations read-only access to measurement data from water infrastructure services. Access is granted per application, and each application can only discover and fetch the environments, sites, and signals included in its permission set.

What the API provides

• A data catalog for discovering readable environments, sites, signals, units, available ranges, and values URLs.
• Values endpoints for fetching measurement data as JSON, NDJSON, or CSV.
• Authentication through Microsoft Entra ID client credentials.
• API Management subscription-key protection for public API calls.

Recommended flow

1. Configure the daemon application with the tenant, API scope, base URL, client credential, and subscription key provided by Preventos.
2. Acquire an access token with the OAuth 2.0 client credentials flow.
3. Call GET /data-catalog to discover the data available to the application.
4. Build scheduled value exports from catalog entries instead of hardcoding site or signal assumptions.
5. Refresh the catalog regularly so permission, site, signal, and availability changes are picked up.

Next steps

• Follow the third-party daemon integration guide for implementation examples in C#, Node.js, Python, and curl.
• Review the client credential renewal placeholder for the planned secret and certificate rotation workflow.
• Read the API Terms draft before building a production integration.