Aller au contenu

API d'évaluation de la mobilité

Convertir les entrées de l'écran d'évaluation de la mobilité en une note de gravité, une carte de la zone affectée et des recommandations pour la mise en œuvre correctives.

Point de terminaison

  • GET /api/v1/fitness/mobility-assessment
  • POST /api/v1/fitness/mobility-assessment/post

Paramètres

Nom Type Obligatoire In Description
ankle_mobility_score nombre (0-100) Oui Requête/Corps Note de mobilité du cheville.
hip_mobility_score nombre (0-100) Oui Requête/Corps Note de mobilité de la hanche.
shoulder_mobility_score nombre (0-100) Oui Requête/Corps Note de mobilité de l'épaule.
posture_type chaîne Oui Requête/Corps neutral,anterior_pelvic_tilt,kyphotic,lordotic,swayback,flat_back.
lang chaîne Non Requête Langue de la réponse (en,es,de,fr,pt,ja,hi,ar).

Pourquoi utiliser ce point de terminaison

  • Convertir les évaluations de la mobilité en un programme correctif structuré.
  • Identifier rapidement les zones de mouvement les plus limitantes.
  • Générer une logique de personnalisation pour le réchauffement des produits d'entraînement.

Commencer

Exemple de requête

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"}'

Exemple de réponse

Info

L'exemple de réponse ci-dessous est uniquement à des fins de démonstration. Pour obtenir la structure JSON complète, en temps réel et potentiellement plus riche, effectuez une requête sur cet 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"}
}

Positionnement du produit

Un point de terminaison central pratique pour les applications de dépistage des mouvements et les workflows SaaS d'entraînement.

Note

Toutes les notes de mobilité doivent être 0-100; les valeurs invalides renvoient une erreur HTTP 400.

Points de terminaison recommandés