API de Plan Semanal¶
Genera un plan estructurado de 7 días con distribución de entrenamiento/descanso y guías de entrenamiento.
Endpoint¶
GET /api/v1/fitness/weekly-planPOST /api/v1/fitness/weekly-plan/post
Parámetros¶
| Nombre | Tipo | Requerido | In | Descripción |
|---|---|---|---|---|
age | entero (13-90) | Sí | Consulta/Cuerpo | Edad en años. |
goal | cadena | Sí | Consulta/Cuerpo | fat_loss,muscle_gain,maintenance,endurance,recomposition. |
training_days | entero (1-7) | Sí | Consulta/Cuerpo | Frecuencia semanal de entrenamiento. |
lang | cadena | No | Consulta | Idioma de la respuesta (en,es,de,fr,pt,ja,hi,ar). |
¿Por qué usar este Endpoint?¶
- Genera instantáneamente un esquema completo de entrenamiento para una semana.
- Mapea el tipo de objetivo a la carga de trabajo y el patrón de recuperación.
- Habilita la automatización del entrenamiento con bloques de plan estándar.
Ejemplo de Solicitud¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/weekly-plan?age=31&goal=recomposition&training_days=5&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/weekly-plan/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"age":38,"goal":"fat_loss","training_days":4}'
Ejemplo de Respuesta¶
Info
El ejemplo de respuesta a continuación es solo para demostración. Para recibir la estructura JSON completa, en tiempo real y potencialmente más rica, realice una solicitud real a este endpoint.
{
"goal": "recomposition",
"goal_label": "Recomposition",
"age": 31,
"training_days": 5,
"rest_days": 2,
"weekly_summary": "Balanced split for composition and performance retention.",
"load_distribution": {"high_days": 2, "moderate_days": 3, "low_or_recovery_days": 2},
"weekly_schedule": [
{"day_index": 1, "day_label": "Day 1", "is_training_day": true, "session_focus": "Upper Strength", "intensity": "High", "recovery_block": "Mobility + sleep target"},
{"day_index": 2, "day_label": "Day 2", "is_training_day": true, "session_focus": "Lower Strength", "intensity": "Moderate", "recovery_block": "Soft tissue + walk"}
],
"execution_guardrails": ["Respect recovery days and trend adherence weekly"],
"adjustment_signals": ["Reduce intensity if recovery trend declines"],
"coach_notes": ["Prioritize consistency over maximal daily effort"],
"language": "en",
"_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "f4d2bd22d394cc74", "quota": 120, "usage_tracking": true},
"_api_metadata_": {"endpoint_name": "fitness_weekly_plan", "response_language": "en"}
}
Posicionamiento del Producto¶
Endpoint principal para productos de entrenamiento con suscripción y plataformas de entrenamiento adaptativo.
Nota
training_days debe estar entre 1 y 7.
Endpoints Recomendados¶
GET /api/v1/fitness/daily-plan- API de Plan DiarioGET /api/v1/fitness/deload-plan- API de Plan de DescargaGET /api/v1/fitness/glycogen-replenishment-plan- API de Plan de Replenimiento de GlucógenoGET /api/v1/fitness/hydration-plan- API de Plan de HidrataciónGET /api/v1/fitness/reverse-diet-plan- API de Plan de Dieta InversaGET /api/v1/fitness/weekly-checkin-analysis- API de Análisis de Chequeo Semanal