← MaterielTrack
· API publique · v1

Intégrez MaterielTrack à votre ERP en quelques minutes

API REST complète : équipements, contrôles VGP avec recalcul automatique des échéances, alertes, documents réglementaires et webhooks signés. Odoo, Sage, GMAO, scripts internes — tout ce qui parle HTTP s'interface.

Démarrage rapide

  1. 1. Créez une clé dans Paramètres → API & Webhooks (admin).
  2. 2. Appelez l'API avec l'en-tête Authorization: Bearer mtk_…
# Lister les équipements dont l'échéance VGP tombe avant fin de mois
curl "https://materieltrack.fr/api/v1/equipments?next_inspection_before=2026-06-30" \
  -H "Authorization: Bearer mtk_votre_cle"

# Déposer un contrôle (l'échéance de l'équipement est recalculée automatiquement)
curl -X POST "https://materieltrack.fr/api/v1/inspections" \
  -H "Authorization: Bearer mtk_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "equipment_uid": "<uid de l'étiquette QR>",
    "inspection_date": "2026-06-10",
    "result": "ok",
    "observations": "RAS"
  }'

Endpoints

Base : https://materieltrack.fr/api/v1 · pagination ?page&per_page (max 200) · 100 req/min par espace · spécification OpenAPI

GET/equipmentsLister les équipements (filtres statut, site, client, échéance, recherche)
POST/equipmentsCréer un équipement (quota du plan appliqué)
GET/equipments/:idFiche complète + dernier contrôle (UUID interne ou uid d'étiquette)
PATCH/equipments/:idMise à jour partielle (webhook si changement de statut)
GET/equipments/:id/qrÉtiquette QR en PNG ou SVG
GET/inspectionsHistorique des contrôles (filtres équipement, résultat, période)
POST/inspectionsDéposer un contrôle — recalcul automatique de l'échéance VGP
POST/syncDépôt en lot (max 200 contrôles, réponse ligne par ligne)
GET/alertsAlertes d'échéance (J-30 / J-7 / J / escalades)
POST/alerts/:id/acknowledgeAccuser réception d'une alerte
GET/documentsBibliothèque documentaire
POST/documentsTéléverser un document (50 Mo) et le lier à un équipement
GET/documents/:idMétadonnées + URL signée de téléchargement (1 h)

Webhooks

Recevez inspection.created, alert.raised et equipment.status_changed sur votre URL. Chaque livraison est signée :

X-MaterielTrack-Event: alert.raised
X-MaterielTrack-Signature: sha256=<HMAC-SHA256(secret, corps)>

{
  "event": "alert.raised",
  "created_at": "2026-06-10T07:00:00.000Z",
  "data": {
    "equipment_reference": "EL-CH-001",
    "alert_type": "j_30",
    "due_date": "2026-07-10"
  }
}

Une question, un connecteur à brancher (Odoo, Sage X3, Microsoft Fabric) ? contact@materieltrack.fr