REST API for Agüita — on-demand water delivery. Customers (the client app) place water orders; drivers (the cisternero app) broadcast-bid, deliver, and get paid; admins operate the platform from a back office.
All endpoints are served under the /api/v1 prefix and return JSON. See
Endpoints for the full reference.
| Section | Description |
|---|---|
| Entities | Data models — what each resource represents and how they relate |
| Business logic | Cross-cutting rules — commission, solidarity fund, order lifecycle, money |
| Pagination | List conventions — page-based, cursor-based, and flat responses |
| Test users | Seeded accounts and credentials for local/dev environments |
| Endpoints | API reference — routes, request/response formats, and errors |
Heads up. These docs are gated in non-dev environments and are meant for the team and API consumers (web, mobile, integrators). Each page is also available as raw Markdown by appending
.mdto its URL (e.g./docs/index.md).