Partage & API - Documentation

MARIAM expose une API REST publique pour permettre à des services tiers (affichage campus, applications étudiantes, écrans connectés, etc.) de consommer les données des menus.

API développeur (v1)

La documentation interactive est disponible sur l’instance MARIAM à l’adresse /api/v1/docs (Swagger UI).

Route	Description
GET /api/v1/menus	Menu du jour et de demain
GET /api/v1/restaurant	Informations du restaurant

Exemple de réponse

{
  "success": true,
  "data": {
    "today": {
      "date": "2026-02-25",
      "day_name": "Mercredi",
      "items": []
    },
    "tomorrow": {
      "date": "2026-02-26",
      "day_name": "Jeudi",
      "items": []
    }
  }
}

Routes publiques internes

Ces routes sont utilisées par l’interface web MARIAM elle-même, mais peuvent aussi être consommées :

Route	Description
GET /api/public/menu/today	Menu du jour
GET /api/public/menu/tomorrow	Menu de demain
GET /api/public/events	Événements à venir

Rate limiting

L’API est protégée par un rate limiter (Redis). Les limites sont appliquées par route pour éviter les abus.

En savoir plus

Le code source et la documentation technique complète sont disponibles sur GitHub : github.com/Tezay/mariam.