Documentation API REST SuperTrace

L'API REST SuperTrace permet aux établissements titulaires d'une licence Business ou Admin d'accéder à leurs enregistrements sanitaires en lecture seule de manière automatisée.

1. Authentification & Clé API

Chaque requête envoyée à l'API doit être authentifiée avec votre Clé API personnelle (générable depuis votre page Mon Profil).

Méthode 1 : En-tête HTTP Authorization (Recommandé) Authorization: Bearer VOTRE_CLE_API
Méthode 2 : Paramètre URL (GET Query) https://supertrace.inovinfo.fr/api/temperatures?api_token=VOTRE_CLE_API

2. Endpoints Disponibles

URL de Base : https://supertrace.inovinfo.fr/api/

GET /api/temperatures

Récupère l'historique complet de vos relevés de températures d'enceintes frigorifiques.

{
  "status": "success",
  "count": 2,
  "data": [
    {
      "id": 142,
      "equipment_name": "Chambre Froide Positive 1",
      "temperature": 3.4,
      "status": "ok",
      "created_at": "2026-08-06 08:30:00"
    },
    {
      "id": 143,
      "equipment_name": "Congélateur Négatif 2",
      "temperature": -18.2,
      "status": "ok",
      "created_at": "2026-08-06 08:31:00"
    }
  ]
}
GET /api/traceability

Récupère la liste de vos étiquettes et produits enregistrés avec URL des photos et mode de conservation.

{
  "status": "success",
  "count": 1,
  "data": [
    {
      "id": 89,
      "product_name": "Saumon Fumé Label Rouge",
      "batch_number": "LOT-89201",
      "dlc": "2026-08-25",
      "storage_type": "Frais",
      "photo_path": "uploads/traceability/1722950400_abc123.jpg",
      "thumbnail_path": "uploads/traceability/1722950400_abc123_thumb.jpg",
      "created_at": "2026-08-06 09:15:00"
    }
  ]
}
GET /api/cleaning

Récupère l'historique de vos émargements de sessions de nettoyage (PND) du Plan de Maîtrise Sanitaire.

{
  "status": "success",
  "count": 1,
  "data": [
    {
      "id": 45,
      "session_date": "2026-08-06",
      "service_type": "midi",
      "created_at": "2026-08-06 14:00:00"
    }
  ]
}

3. Codes de Statut HTTP

Code HTTP Description & Signification
200 OK Requête traitée avec succès. Données JSON fournies.
401 Unauthorized Jeton API manquant dans la requête (en-tête ou query).
403 Forbidden Jeton API invalide ou licence insuffisante (Licence Business requise).