{"openapi":"3.1.0","info":{"title":"FalcoFit Exercise API","version":"1.0.0","description":"Catalogo ufficiale FalcoFit con oltre 500 esercizi, istruzioni e video. Le informazioni sono educative e non sostituiscono il parere di un professionista sanitario."},"servers":[{"url":"https://chatgpt.falcofit.it"}],"paths":{"/api/exercises":{"get":{"operationId":"searchExercises","summary":"Cerca esercizi FalcoFit","description":"Cerca e filtra il catalogo. Usa home_only=true quando l’utente chiede esercizi da svolgere a casa.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Testo da cercare nel nome e nella descrizione"},{"name":"category","in":"query","schema":{"type":"string"},"description":"Categoria esatta, per esempio petto, gambe, core o yoga"},{"name":"equipment","in":"query","schema":{"type":"string"},"description":"Attrezzo disponibile"},{"name":"muscle","in":"query","schema":{"type":"string"},"description":"Gruppo muscolare"},{"name":"body_type","in":"query","schema":{"type":"string","enum":["corpo_libero","misto","con_peso"]}},{"name":"difficulty","in":"query","schema":{"type":"integer","minimum":1,"maximum":5}},{"name":"home_only","in":"query","schema":{"type":"boolean"},"description":"Restituisce soltanto esercizi adatti a casa"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20,"default":10}}],"responses":{"200":{"description":"Risultati della ricerca","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}}}}},"/api/exercises/{code}":{"get":{"operationId":"getExerciseDetails","summary":"Ottieni i dettagli di un esercizio","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dettagli, istruzioni, errori comuni, varianti e video","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Exercise"}}}},"404":{"description":"Esercizio non trovato"}}}},"/api/categories":{"get":{"operationId":"getExerciseFilters","summary":"Elenca categorie, attrezzi e difficoltà disponibili","responses":{"200":{"description":"Filtri disponibili"}}}}},"components":{"schemas":{"Exercise":{"type":"object","properties":{"codice":{"type":"string"},"nome":{"type":"string"},"categoria":{"type":"string"},"sotto_categoria":{"type":"string"},"attrezzo":{"type":"string"},"tipo_corpo":{"type":"string"},"difficolta":{"type":["integer","null"]},"gruppi_muscolari":{"type":"array","items":{"type":"string"}},"adatto_a_casa":{"type":"boolean"},"descrizione_breve":{"type":"string"},"istruzioni":{"type":"string"},"errori_comuni":{"type":"string"},"varianti":{"type":"string"},"video_urls":{"type":"array","items":{"type":"string","format":"uri"}}}},"SearchResult":{"type":"object","properties":{"total_matches":{"type":"integer"},"returned":{"type":"integer"},"exercises":{"type":"array","items":{"$ref":"#/components/schemas/Exercise"}}}}}}}