Zum Inhalt

Race-Zeit-Vorhersage-API

Prognostiziert die Ergebnisse von Rennen auf Basis aktueller Leistungs- und Fitnessdaten.

Endpoint

  • GET /api/v1/fitness/race-time-predictor
  • POST /api/v1/fitness/race-time-predictor/post

Parameter

Name Type Erforderlich In Beschreibung
recent_5k_time string/number Ja Query/Body 5K-Zeit in Sekunden, Minuten oder Stunden.
vo2max number (20-90) Ja Query/Body VO2 max-Wert.
weekly_mileage number (0-250) Ja Query/Body Kilometerleistung pro Woche.
lang string Nein Query Antwortsprache (en,es,de,fr,pt,ja,hi,ar).

Warum diesen Endpoint verwenden

  • Liefert Wettprognosen, die auf aktuellen Fitnesssignalen basieren.
  • Fügt Kontext zu Bereitschaft und Vertrauen hinzu, um die Ausführung zu planen.
  • Verbessert die Pacing- und Zielsetzungs-Workflows in Lauf-Apps.

Jetzt starten

Beispiel für eine Anfrage

curl -X GET "https://api.hefitapi.com/api/v1/fitness/race-time-predictor?recent_5k_time=22:30&vo2max=49&weekly_mileage=42&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/race-time-predictor/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"recent_5k_time":"23:45","vo2max":45,"weekly_mileage":34}'

Beispiel für eine Antwort

Info

Das untenstehende Antwortbeispiel dient nur zur Demonstration. Um die vollständige, Echtzeit- und möglicherweise reichhaltigere JSON-Struktur zu erhalten, senden Sie eine Anfrage an diesen Endpoint.

{
  "recent_5k_time": "22:30",
  "vo2max": 49.0,
  "weekly_mileage_km": 42.0,
  "readiness_band": {
    "level": "developing",
    "level_label": "Developing",
    "insight": "Fitness profile supports progressive race-specific work."
  },
  "projection_10k": {"time": "47:22", "seconds": 2842},
  "projection_half_marathon": {"time": "1:44:50", "seconds": 6290},
  "projection_marathon": {"time": "3:39:25", "seconds": 13165},
  "training_focus": "Build threshold consistency and long-run efficiency.",
  "confidence_score": 86,
  "summary": "Solid progression profile with actionable race readiness.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "b84e92708fac339d", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_race_time_predictor", "response_language": "en"}
}

Produktpositionierung

Eine Premium-Funktion für Lauf-Coach-SaaS, Endurance-Planungs-Apps und Wettvorbereitungsprodukte.

Anmerkung

recent_5k_time muss einen realistischen 5K-Bereich (11:00 bis 75:00) darstellen.

Empfohlene Endpoints