Développeurs

API &
Développeurs

Intégrez MaintForge dans votre écosystème grâce à notre API REST complète.

API REST

API REST v1

L'API MaintForge permet d'accéder à toutes les fonctionnalités de la plateforme de manière programmatique. Créez des intégrations, automatisez vos workflows et connectez MaintForge à vos outils existants.

Base URL

/api/v1/

Authentification

Session (navigateur) + JWT Bearer Token (intégrations)

Format

JSON uniquement. Pagination par curseur. Rate limiting : 1000 requêtes/heure par token.

Endpoints

Principaux endpoints

Ressource Endpoint Méthodes
Équipements /api/v1/equipments/ GET, POST, PUT, DELETE
Ordres de travail /api/v1/workorders/ GET, POST, PUT, DELETE
Incidents /api/v1/incidents/ GET, POST, PUT, DELETE
Capteurs /api/v1/sensors/ GET, POST
Analytics /api/v1/analytics/ GET
Documentation

Documentation interactive

Testez les endpoints directement depuis votre navigateur grâce à nos outils de documentation interactive.

Webhooks

Webhooks

Recevez des notifications en temps réel lorsque des événements se produisent dans MaintForge.

equipment.created

Nouvel équipement ajouté

equipment.updated

Équipement modifié

workorder.created

Nouvel ordre de travail

workorder.completed

Ordre de travail terminé

incident.reported

Incident signalé

incident.resolved

Incident résolu

sensor.alert

Alerte capteur déclenchée

sensor.data

Nouvelles données capteur

predictive.recommendation

Nouvelle recommandation prédictive

predictive.threshold

Seuil R80 franchi

export.ready

Export de données prêt

Exemples

Exemple d'utilisation

# Lister les équipements

curl -X GET https://app.maintforge.com/api/v1/equipments/ \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json"

# Réponse

{
  "count": 42,
  "next": "/api/v1/equipments/?cursor=abc123",
  "results": [
    {
      "id": 1,
      "name": "Compresseur Atlas Copco GA-37",
      "location": "Atelier A - Zone 3",
      "reliability": 0.87,
      "rul_hours": 1250,
      "status": "operational"
    }
  ]
}

Essai gratuit pour tester l'API

Créez un compte d'essai et obtenez un token API en quelques minutes.