API v1.0 · OPERATIONAL

Data flows
like water.
Built for Water Worker.

The DataPipeline API powers wapi_app with reliable, real-time data streams between sensors, services, and the field. One pipeline. Zero drips.

99.9%
Uptime
<120ms
Latency
REST
JSON · OpenAPI
pipeline.flow
SENSOR field.iot /api DataPipeline DATABASE wapi _app CLIENT WORKER queue.job ingest → transform → deliver
// real-time stream FLOWING
💧 Real-time Ingestion · RESTful Architecture · 📡 IoT Sensor Ready · OpenAPI 3.0 · 🔐 Token Auth · Laravel 12 Powered · ⚡ Sub-second Response · 💧 Real-time Ingestion · RESTful Architecture · 📡 IoT Sensor Ready · OpenAPI 3.0 · 🔐 Token Auth · Laravel 12 Powered · ⚡ Sub-second Response ·
// 02 · Capabilities

Engineered for the
last mile of water data.

Real-time Ingestion

Stream sensor readings, meter logs, and field events with low-latency endpoints designed for high-throughput water telemetry.

Reliable Scheduling

Queued jobs, retries with backoff, and idempotent writes — your data lands once, exactly when expected.

Token Authentication

Sanctum-backed bearer tokens, scoped access, and per-client rate limits keep your pipeline secure end-to-end.

Aggregations & Reports

Roll up consumption, pressure, and flow metrics on demand. Export-ready payloads for dashboards and wapi_app views.

Developer Friendly

Clean JSON contracts, descriptive error codes, and an interactive Swagger UI to test every endpoint in seconds.

Observability

Built-in request logging, health probes, and structured failures so issues surface before they become outages.

// 03 · Surface

A clean
API surface.

Every route is documented in OpenAPI 3.0 and rendered live via Swagger at /api/documentation.

Open full reference
BASE_URL/api v1.0
GET /api/health
POST /api/auth/token
POST /api/pipeline/ingest
GET /api/readings
GET /api/readings/{id}
PUT /api/workers/{id}
GET /api/reports/summary
DEL /api/auth/token
// 04 · Workflow

From sensor to wapi_app in three pulses.

01

Authenticate

Request a bearer token with your client credentials.

POST /api/auth/token
02

Ingest

Push readings, meter events, or worker logs to the pipeline.

POST /api/pipeline/ingest
03

Consume

wapi_app reads aggregated, validated data ready to render.

GET /api/readings
Ready to Connect

Plug into the
DataPipeline today.

Open Swagger, grab a token, and stream your first reading in under a minute.