🚀 Predictive Maintenance API for Industrial Equipment

An AI-powered solution to monitor, analyze, and predict failures in industrial equipment.
Integrating IoT sensors and ERP systems, this API processes real-time data to detect anomalies and prevent failures before they occur—reducing costs and downtime.

---

🔗 Live API

Base URL: https://predictive-maintenance-api.up.railway.app/

---

✨ Key Features

✅ Real-Time Monitoring – Collect and analyze sensor data, including temperature, vibration, and energy consumption.
✅ AI-Powered Failure Prediction – Machine learning algorithms identify patterns and anticipate mechanical failures.
✅ Detailed Reports – Generate insights and statistics for each piece of equipment.
✅ Custom Configuration – Adjust thresholds and limits based on your operational needs.
✅ Seamless Integration – Designed to work with ERP systems and industrial platforms.
✅ Secure Authentication – API key-based access for enhanced security.

---

🔧 Installation

To run this API locally, follow these steps:

1️⃣ Clone this repository

git clone https://github.com/MicaelSoares7/predictive-maintenance-api.git
cd predictive-maintenance-api

2️⃣ Create a virtual environment (optional but recommended)

python -m venv venv
source venv/bin/activate  # On macOS/Linux
venv\Scripts\activate  # On Windows

3️⃣ Install dependencies

pip install -r requirements.txt

4️⃣ Run the API

uvicorn PredictiveX:app --host 0.0.0.0 --port 8000

The API will be available at: http://127.0.0.1:8000

---

📌 API Endpoints

🟢 Add Equipment Data

POST /equipamento/{equip_id}/dados

🔹 Request Example

{
  "temperatura": 75.5,
  "vibracao": 4.2,
  "energia": 450.0
}

🔹 Response Example

{
  "message": "Data received successfully",
  "status": "OK"
}

---

📊 Get Equipment Report

GET /equipamento/{equip_id}/relatorio

🔹 Response Example

{
  "equipamento_id": "123",
  "historico": [
    {"temperatura": 75.5, "vibracao": 4.2, "energia": 450.0, "timestamp": "2025-02-19T12:00:00"}
  ],
  "status": "Normal",
  "previsao_falha": false
}

---

⚙️ Configure Equipment Limits

POST /equipamento/{equip_id}/configurar_limites

🔹 Request Example

{
  "temperatura_max": 100,
  "vibracao_max": 5.0,
  "energia_max": 500
}

🔹 Response Example

{
  "message": "Thresholds updated successfully",
  "status": "OK"
}

---

🔐 Authentication

To use this API, include an API Key in the request headers:

{
  "x-api-key": "your-api-key-here"
}

---

📡 Testing the API Online

You can test the API directly on your hosted endpoint using Postman or cURL:

curl -X GET "https://predictive-maintenance-api.up.railway.app/equipamento/123/relatorio" -H "x-api-key: your-api-key-here"

---

🚀 Business Benefits

🔹 Lower maintenance costs – Reduce unplanned downtime and avoid costly repairs.
🔹 Increased equipment availability – Minimize operational disruptions.
🔹 Optimized production efficiency – Enhance performance and reduce waste.
🔹 Scalable and flexible – Easily integrates with existing industrial platforms.

💡 Available as a REST API for seamless integration.

---

📩 Get in Touch

Have questions or need support? Feel free to reach out!