API de Avaliação da Mobilidade¶
Transforme as entradas da tela de avaliação da mobilidade em uma pontuação de gravidade, um mapa da região limitada e orientação para a execução corretiva.
Endpoint¶
GET /api/v1/fitness/mobility-assessmentPOST /api/v1/fitness/mobility-assessment/post
Parâmetros¶
| Nome | Tipo | Obrigatório | In | Descrição |
|---|---|---|---|---|
ankle_mobility_score | número (0-100) | Sim | Consulta/Corpo | Pontuação da mobilidade do tornozelo. |
hip_mobility_score | número (0-100) | Sim | Consulta/Corpo | Pontuação da mobilidade do quadril. |
shoulder_mobility_score | número (0-100) | Sim | Consulta/Corpo | Pontuação da mobilidade do ombro. |
posture_type | string | Sim | Consulta/Corpo | neutral,anterior_pelvic_tilt,kyphotic,lordotic,swayback,flat_back. |
lang | string | Não | Consulta | Idioma da resposta (en,es,de,fr,pt,ja,hi,ar). |
Por que Usar Este Endpoint¶
- Converta as avaliações da mobilidade em programação corretiva estruturada.
- Identifique rapidamente as regiões de movimento mais limitantes.
- Gere lógica de personalização para produtos de treinamento.
Exemplo de Requisição¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/mobility-assessment?ankle_mobility_score=52&hip_mobility_score=61&shoulder_mobility_score=68&posture_type=anterior_pelvic_tilt&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/mobility-assessment/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"ankle_mobility_score":58,"hip_mobility_score":55,"shoulder_mobility_score":63,"posture_type":"kyphotic"}'
Exemplo de Resposta¶
Info
O exemplo de resposta abaixo é apenas para fins demonstrativos. Para obter a estrutura JSON completa, em tempo real e potencialmente mais rica, faça uma requisição para este endpoint.
{
"ankle_mobility_score": 52.0,
"hip_mobility_score": 61.0,
"shoulder_mobility_score": 68.0,
"posture_type": "anterior_pelvic_tilt",
"posture_type_label": "Anterior Pelvic Tilt",
"composite_mobility_score": 60,
"restriction_severity": {
"score": 47,
"level": "moderate",
"level_label": "Moderate",
"insight": "Mobility deficits may limit movement quality under load."
},
"limiting_regions": [
{"region": "ankle", "region_label": "Ankle", "score": 52.0, "restriction_level": "moderate"},
{"region": "hip", "region_label": "Hip", "score": 61.0, "restriction_level": "moderate"},
{"region": "shoulder", "region_label": "Shoulder", "score": 68.0, "restriction_level": "low"}
],
"corrective_focus": ["Restore ankle and hip mobility through daily drills"],
"warmup_customization_advice": ["Add mobility prep before loaded sessions"],
"retest_window_days": 21,
"confidence_score": 76,
"summary": "Moderate restriction profile with targeted corrective opportunity.",
"language": "en",
"_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "71d65d488d78d9b4", "quota": 120, "usage_tracking": true},
"_api_metadata_": {"endpoint_name": "fitness_mobility_assessment", "response_language": "en"}
}
Posicionamento do Produto¶
Um endpoint central prático para aplicativos de avaliação de movimento e fluxos de trabalho SaaS de treinamento.
Nota
Todas as pontuações de mobilidade devem ser 0-100; valores inválidos retornam HTTP 400.
Endpoints Recomendados¶
GET /api/v1/bmi- API de BMIGET /api/v1/tdee- API de TDEEGET /api/v1/bmr- API de BMRGET /api/v1/protein-calculator- API de Calculadora de ProteínaGET /api/v1/fitness/heart-rate-zones- API de Zonas de Frequência CardíacaGET /api/v1/bodyfat- API de Gordura Corporal