Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/CspmIT/mas-agua-front/llms.txt

Use this file to discover all available pages before exploring further.

​
Introduction

The Mas Agua API is a RESTful API that provides programmatic access to water management data, including real-time monitoring, charts, diagrams, and system configuration. All API endpoints are accessed via HTTP and return JSON responses.

​
Base URL

The API base URL varies by environment: 
http://localhost:4000/api

​
Request Structure

All API requests are made using standard HTTP methods:
  • GET - Retrieve data
  • POST - Create or submit data
  • PUT - Update existing data
  • DELETE - Remove data

​
Content Type

All requests must include the following headers: 
Content-Type: application/json
Accept: application/json

​
Response Format

API responses are returned in JSON format with the following structure:

​
Success Response

{
  "data": {
    // Response data object or array
  }
}

​
Error Response

When an error occurs, the API returns an HTTP error status code along with an error message: 
{
  "error": {
    "message": "Error description",
    "code": "ERROR_CODE"
  }
}

​
Error Handling

The Mas Agua API uses standard HTTP status codes:
Status CodeDescription
200Success - Request completed successfully
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient permissions
404Not Found - Resource does not exist
500Internal Server Error - Server-side error occurred

​
Error Handling in Code

The API utility handles 500 errors specially by extracting detailed error messages: 
try {
  const response = await axios({
    method: 'POST',
    url: `${baseUrl}/api/endpoint`,
    data: requestData,
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json',
      'Authorization': `Bearer ${token}`
    }
  });
  return response;
} catch (error) {
  if (error.response?.status === 500) {
    let messageError = '';
    const errors = error.response.data;
    for (const key in errors) {
      if (Object.hasOwnProperty.call(errors, key)) {
        messageError += ' ' + errors[key].message;
      }
    }
    throw messageError;
  } else {
    throw error;
  }
}
Refer to the source implementation at src/utils/js/request.js:26-38.

​
Rate Limiting

Currently, the Mas Agua API does not enforce rate limiting. However, clients should implement reasonable request throttling to avoid overwhelming the server.

​
CORS and Credentials

All authenticated requests are made with credentials: 
withCredentials: true
This allows the API to accept cookies and authentication tokens from cross-origin requests.

​
API Clients

Mas Agua provides JavaScript utilities for making API requests:
  • request(url, method, data) - Authenticated requests with JWT token
  • requestPublic(url, method, data) - Public endpoints without authentication
  • requestFile(url, method, data) - File upload requests with special credentials
See Authentication for details on using these utilities.

​
Next Steps

Authentication

Learn how to authenticate API requests using JWT tokens

Endpoints

Explore available API endpoints and their usage

Build docs developers (and LLMs) love

Get started for freeTalk to us