Vue d’ensemble

Base URL locale : http://localhost:3000/api/public

Endpoints publics : santé, itinéraire, commerces, catégories, bus temps réel.

Documentation machine-readable : GET /api/public

Authentification (optionnelle)

Si la variable serveur PUBLIC_API_KEY est définie, il faut envoyer l’en-tête x-api-key.

curl -H "x-api-key: VOTRE_CLE" "http://localhost:3000/api/public/health"

Endpoints

• GET /api/public : index de l’API
• GET /api/public/health : état du service
• GET /api/public/route : calcul d’itinéraire (params: mode, start, end)
• GET /api/public/shops : commerces + lieux d’expérience
• GET /api/public/shops/categories : catégories de commerces
• GET /api/public/buses : positions bus temps réel

Exemples

# Health
curl "http://localhost:3000/api/public/health"

# Route à pied
curl "http://localhost:3000/api/public/route?mode=walking&start=6.1757,49.1193&end=6.1830,49.1140"

# Commerces
curl "http://localhost:3000/api/public/shops"

# Catégories
curl "http://localhost:3000/api/public/shops/categories"

# Bus temps réel
curl "http://localhost:3000/api/public/buses"

Serveur MCP

Le projet fournit aussi un serveur MCP pour agents personnels : mcp-server.js.

# Lancer le serveur web Metz Connect
npm start

# Lancer le serveur MCP (stdio)
npm run mcp:start

Le serveur MCP expose des tools pour health, route, shops, catégories et bus.