API-Endpunkte zum Abrufen

Unser System stellt mehrere Endpunkte bereit, die Sitzungsdetails zurückgeben – einschließlich der URL zum verarbeiteten (analysierten) Video. Verwenden Sie den Endpunkt, der zur Aktivität Ihrer Sitzung passt:

A. Sitzungsspezifische Endpunkte

Sprungsitzungen

• Endpunkt: GET /jumping/sessions/{session_id}/

• Beschreibung: Ruft detaillierte Daten für eine Sprungsitzung ab. Die Antwort enthält eine analyzed_video_url (eine öffentliche URI, die auf das analysierte Video verweist) zusammen mit der ursprünglichen video_url und weiteren Sitzungsmetriken.

• Beispielantwort-Fragment:

{
  "session_id": "abcd1234",
  "analyzed_video_url": "https://storage.googleapis.com/your-bucket/analyzed_video.mp4",
  "video_url": "https://storage.googleapis.com/your-bucket/original_video.mov",
  "created_at": { "date": "05/02/2025", "time": "06:00 PM" },
  ...
}

GET /jumping/sessions/{session_id}/export/ Exportiert umfassende Daten für eine Sprungsitzung. Dieser Endpunkt liefert markante Schlüsselstellen, Winkelinformationen und weitere Metriken, die für eine tiefgehende Analyse nützlich sind.

---

Laufsitzungen

• Endpunkt: GET /running/sessions/{session_id}/

• Beschreibung: Gibt Details für eine Laufsitzung zurück. Die Antwort enthält eine analyzed_video_url zusammen mit Metriken, Winkeln, Zeitstempeln und weiteren relevanten Daten.

• Beispielantwort-Fragment:

{
  "session_id": "abcd1234",
  "analyzed_video_url": "https://storage.googleapis.com/your-bucket/analyzed_video.mp4",
  "video_url": "https://storage.googleapis.com/your-bucket/original_video.mov",
  "created_at": { "date": "05/02/2025", "time": "06:00 PM" },
  ...
}

• GET /running/sessions/{session_id}/export/ Exportiert Laufsitzungsdaten für eine weitere Analyse. Dies umfasst Schlüsselstellen, Winkel, Zeitstempel und zusätzliche Leistungsmetriken.

• GET /sessions/{session_id}/analyzed-video/ Ruft die URL für das analysierte Video ab. Falls das Video noch nicht verfügbar ist, kann dieser Endpunkt dessen Generierung auslösen.

---

Gewichthebungssitzungen

• Endpunkt: GET /weightlifting/sessions/{session_id}/

• Beschreibung: Ruft Details für eine Gewichthebungssitzung ab. Neben übungsspezifischen Metriken und Winkeln gibt die Antwort eine analyzed_video_url zurück, die das verarbeitete Heben zeigt.

• Beispielantwort-Fragment:

{
  "session_id": "abcd1234",
  "analyzed_video_url": "https://storage.googleapis.com/your-bucket/analyzed_video.mp4",
  "video_url": "https://storage.googleapis.com/your-bucket/original_video.mov",
  "created_at": { "date": "05/02/2025", "time": "06:00 PM" },
  ...
}

• GET /weightlifting/sessions/{session_id}/export/

  Exportiert Gewichthebungssitzungsdaten, die Schlüsselstellen, Winkel, Zeitstempel und numerische Metriken umfassen.

• GET /weightlifting/sessions/{session_id}/lift-analysis/ Ruft detaillierte Analysebilder und Empfehlungen für das Heben ab. Dieser Endpunkt liefert mehrsprachige Analysergebnisse für eine weitere Überprüfung.

---

Sitzungsverwaltung – Analysiertes Video

• Endpunkt: GET /session-management/sessions/{session_id}/analyzed-video/

• Beschreibung: Dieser Endpunkt ruft entweder die URL des analysierten Videos für eine Sitzung ab (wenn die Verarbeitung abgeschlossen ist) oder löst eine Such-/Erstellungsroutine aus, falls sie noch nicht verfügbar ist.

• Beispielanfrage:

GET /session-management/sessions/abcd1234/analyzed-video/ HTTP/1.1
Host: api.example.com
API-KEY: <token>

B. Sicherheit und Nutzung

• Authentifizierung: Jeder Abrufaufruf erfordert einen gültigen Token im API-KEY-Header.

• Zugriffskontrolle: Nur authentifizierte Benutzer (mit entsprechenden Berechtigungen) dürfen Sitzungsdetails abrufen. Unbefugte Anfragen führen zu HTTP-401-Antworten mit einer klaren Fehlermeldung.