Aller au contenu

API de référence de la force

Évaluez la force totale et la force spécifique au développé, par rapport au poids corporel, avec des indications axées sur la progression.

Point de terminaison

  • GET /api/v1/fitness/strength-benchmark
  • POST /api/v1/fitness/strength-benchmark/post

Paramètres

Nom Type Obligatoire Valeur Description
gender chaîne Oui Requête/Corps male ou female.
weight nombre (35-300) Oui Requête/Corps Poids corporel en kg.
squat_1rm nombre (20-450) Oui Requête/Corps 1RM pour le développé en kg.
bench_1rm nombre (15-350) Oui Requête/Corps 1RM pour le bench press en kg.
deadlift_1rm nombre (30-500) Oui Requête/Corps 1RM pour le soulevé de terre en kg.
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

  • Standardiser la classification de la force pour les produits d'entraînement.
  • Identifier les exercices les plus faibles pour une progression ciblée.
  • Ajouter de la confiance et des conseils de développement aux rapports de force.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/fitness/strength-benchmark?gender=male&weight=82&squat_1rm=150&bench_1rm=105&deadlift_1rm=195&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/strength-benchmark/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"gender":"female","weight":64,"squat_1rm":102,"bench_1rm":58,"deadlift_1rm":128}'

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 à cet endpoint.

{
  "gender": "male",
  "bodyweight_kg": 82.0,
  "one_rep_max_kg": {"squat_1rm": 150.0, "bench_1rm": 105.0, "deadlift_1rm": 195.0, "total_1rm": 450.0},
  "relative_strength_ratios": {"squat_to_bw": 1.83, "bench_to_bw": 1.28, "deadlift_to_bw": 2.38, "total_to_bw": 5.49},
  "classification_level": "advanced",
  "classification_label": "Advanced",
  "lift_classification": {
    "squat": {"level": "advanced", "label": "Advanced"},
    "bench": {"level": "advanced", "label": "Advanced"},
    "deadlift": {"level": "elite", "label": "Elite"}
  },
  "weakest_link_focus": {"lift": "bench", "label": "Bench", "guidance": "Prioritize bench-focused volume and technique quality."},
  "strength_balance_index": 88,
  "confidence": {"level": "high", "label": "High"},
  "development_guidance": ["Use progressive overload with weak-link emphasis"],
  "summary": "Advanced total profile with clear bench-focused upside.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "f8910571e304d536", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_strength_benchmark", "response_language": "en"}
}

Positionnement du produit

Idéal pour les applications de force, les portails d'athlètes et les plateformes de coaching de performance d'entreprise.

Note

Les valeurs 1RM en dehors des plages valides renvoient une erreur HTTP 400.

Points de terminaison recommandés