Riferimento API
La simulazione espone una superficie FastAPI. Documentazione OpenAPI interattiva (Swagger UI):
Swagger UI
Sullo stesso host dell’app, percorso /docs:
- Produzione: https://foilbench.onrender.com/docs
Non confondere
Questa guida utente è disponibile sotto /docs/… (DE), /docs/en/…, /docs/fr/…, /docs/it/…. Swagger OpenAPI si trova sotto /docs (percorso root).
Endpoint (riepilogo)
Simulazione
| Endpoint | Scopo |
|---|---|
GET /catalog | Brand e componenti |
GET /defaults | Default, limiti slider, reference_setups |
POST /simulate/steady | Curve in regime stazionario inclusi max_speed / max_speed_kmh (Vmax) |
POST /simulate/pump | Integrazione del ciclo di pump |
POST /simulate/optimum | Ricerca dell’ottimo di pump |
POST /simulate/compare | Fino a tre setup affiancati |
Analisi (MVP+)
| Endpoint | Scopo |
|---|---|
POST /analyze/tradeoff | Trade-off tra setup di base e candidato |
POST /analyze/tradeoff/reference | Trade-off vs. rig di riferimento (es. PNGv2 1400) |
POST /analyze/pump-coach | Score pump, scostamenti, consigli, patch di ottimo |
Gli endpoint di analisi restituiscono dati strutturati con campi message_key per la localizzazione UI — nessuna stringa UI hardcoded nell’API.
POST /analyze/tradeoff (focus high_speed) pesa di più la metrica max_speed_kmh e il drag totale rispetto al solo picco L/D.
Disponibili anche sotto /api/….