Laufen
Anfragekörper (Multipart/Form-Data)
Antwortstruktur
Ablauf
Beispiel cURL: ```bash curl -X POST \
-H 'Content-Type: multipart/form-data' \
-H 'Authorization: API-KEY <YOUR_ADMIN_TOKEN>' \
-F 'user_id=someUserId123' \
-F 'video=@/path/to/video.mp4' \
-F 'session_name=Custom Session' \
-F 'incline_degree=5' \
-F 'body_joint_angles=elbow, knee, ankle' \
https://<backend-link>/running/management/sessions/Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Erforderlich. Die ID des Benutzers, für den diese Sitzung erstellt wird (Formularfeld: Text).
Erforderlich. Die zu verarbeitende Videodatei (Formularfeldtyp: Datei).
Optional. Ein beschreibender Name für die Sitzung (Formularfeld: Text).
Optional. Ein numerischer String, der den Neigungswinkel angibt (Formularfeld: Text).
Optional. Eine kommagetrennte Liste von Gelenknamen. Verfügbare Werte: ankle, knee, elbow, hip, shoulder. Beispiel: ankle,knee,hip
Video-Verarbeitungssitzung erfolgreich erstellt (HTTP 200).
Die eindeutige Kennung für die erstellte Sitzung.
Der Sitzungstitel (Standardwert, falls nicht angegeben).
Ungültige Anfrage - Möglicherweise aufgrund fehlender user_id, fehlender video oder ungültiger Formulardaten.
Nicht autorisiert - Fehlender oder ungültiger Zugriffstoken.
Verboten - Der Benutzer hat keine Admin-Berechtigung, um Sitzungen für andere zu erstellen.
Nicht gefunden - Geschäftslogikprobleme oder Ressourcenbeschränkungen (z.B. Sitzungslimit).
Interner Serverfehler - Unerwarteter Fehler auf dem Server.
Pfadparameter - session_id (string, erforderlich): Die eindeutige Kennung der abzurufenden Sitzung.
Abfrageparameter - demo (boolean, optional): Auf true setzen, um Demo-Laufsitzungsdaten anstelle echter Daten abzurufen.
true setzen, um Demo-Laufsitzungsdaten anstelle echter Daten abzurufen.Antwortstruktur Bei Erfolg (HTTP 200) ist die Antwort ein JSON-Objekt mit folgenden Feldern: - metrics (object): Ein Wörterbuch mit Metriken-Arrays (z.B. Geschwindigkeit, Kadenz, Distanz). - angles (object): Ein Wörterbuch mit Winkel-Arrays (z.B. lhip_angle, rsho_angle). - all_timestamps (array[number]): Eine Liste von Zeitstempeln (in Sekunden) für die Sitzungsdaten. - analyzed_video_url (string, URI): Die URL des analysierten Videos (mit Keypoint-Overlay). - video_url (string, URI): Die URL des hochgeladenen Originalvideos. - segments (integer): Die Anzahl der verarbeiteten Segmente. - created_at (object): Enthält das Erstellungsdatum und -zeit. - user_name (string): Der Name des mit der Sitzung verknüpften Benutzers. - activity (string): Die Aktivitätsart (z.B. 'Running'). - title (string): Der Titel der Sitzung. - calculated_metrics (object): Ein Wörterbuch mit berechneten Statistiken. - summary (string): Eine optionale textuelle Zusammenfassung der Sitzung.
Fehlerbehandlung - 400 Ungültige Anfrage: Ungültige Parameter (z.B. ungültige Admin-UID). - 401 Nicht autorisiert: Fehlender oder ungültiger Zugriffstoken. - 403 Verboten: Unzureichende Berechtigungen zum Zugriff auf die Sitzung. - 404 Nicht gefunden: Die Sitzung existiert nicht oder ist für die angegebene Aktivität ungültig. - 500 Interner Serverfehler: Ein unerwarteter serverseitiger Fehler.
Sicherheit Ein gültiger API-KEY-Token muss im Authorization-Header angegeben werden.
Authorization-Header angegeben werden.Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um Demo-Laufsitzungsdaten anstelle echter Daten abzurufen.
Sitzungsdaten erfolgreich abgerufen.
Liste von Zeitstempeln, die mit der Sitzung verknüpft sind.
Die öffentliche URL des analysierten Videos.
Die öffentliche URL des Originalvideos.
Die Anzahl der verarbeiteten Segmente.
Der Name des mit dieser Sitzung verknüpften Benutzers.
Die Art der Aktivität (z.B. "Running").
Der Sitzungstitel.
Eine optionale Zusammenfassung der Sitzung.
Ungültige Anfrage - Ungültige Parameter oder Admin-UID.
Nicht autorisiert - Fehlender oder ungültiger Zugriffstoken.
Verboten - Der Benutzer ist nicht berechtigt, auf diese Sitzung zuzugreifen.
Nicht gefunden - Die angeforderte Sitzung existiert nicht oder die Aktivität ist nicht "Running".
Interner Serverfehler - Ein unerwarteter Fehler ist auf dem Server aufgetreten.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um die vorgefertigte Demo-Laufsitzung anstelle einer echten abzurufen.
Sitzungsdaten erfolgreich exportiert.
Liste von Zeitstempeln (in Sekunden).
Array, das den Kontaktstatus anzeigt (true/false).
Der Aktivitätstyp (z.B. 'Running').
Ungültige Anfrage - Die Anfrageparameter sind ungültig (z.B. ungültige Admin-UID).
Nicht autorisiert - Zugriffstoken fehlt oder ist ungültig.
Verboten - Der Benutzer hat nicht ausreichende Berechtigungen, um auf diese Sitzungsdaten zuzugreifen.
Nicht gefunden - Die angeforderte Sitzung existiert nicht oder die Aktivität ist ungültig.
Interner Serverfehler - Ein unerwarteter Fehler ist auf dem Server aufgetreten.
Antwortstruktur (HTTP 200)
Fehlerbehandlung - 400 Ungültige Anfrage: Ungültige Parameter (z.B. ungültige Admin-UID). - 401 Nicht autorisiert: Fehlender oder ungültiger Zugriffstoken. - 403 Verboten: Unzureichende Berechtigungen zum Abrufen der Gesamtmetriken. - 404 Nicht gefunden: Keine Sitzungen gefunden oder Metriken nicht verfügbar. - 500 Interner Serverfehler: Unerwarteter Fehler auf dem Server.
Sicherheit Ein gültiger API-KEY-Token muss im Authorization-Header angegeben werden.
Authorization-Header angegeben werden.Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Gesamtmetriken erfolgreich abgerufen.
Ungültige Anfrage - Ungültige Parameter (z.B. ungültige Admin-UID).
Nicht autorisiert - Fehlender oder ungültiger Zugriffstoken.
Verboten - Der Benutzer hat keine ausreichenden Berechtigungen zum Abrufen der Gesamtmetriken.
Nicht gefunden - Keine Sitzungen gefunden oder Metriken nicht verfügbar.
Interner Serverfehler - Ein unerwarteter Fehler ist auf dem Server aufgetreten.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um einen vorgefertigten Demo-Laufform-Analysebericht anstelle eines echten abzurufen.
Laufform-Analysebericht erfolgreich abgerufen.
Berichtsdatum im Format TT/MM/JJJJ.
13/07/2025Ungültige Anfrage - Ungültiger Token oder Parameter.
Nicht autorisiert - Token ist ungültig oder abgelaufen.
Verboten - Admin-Zugriff ist erforderlich.
Nicht gefunden - Sitzung nicht gefunden oder Benutzer hat keinen gültigen Zahlungsplan.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Threads erfolgreich erstellt
Benutzer hat keinen gültigen Zahlungsplan
Sitzung nicht gefunden oder anderer Abruf fehlgeschlagen
Unerwarteter Serverfehler
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um einen vorgefertigten Demo-Ganganalyse-Bericht anstelle eines echten abzurufen.
Ganganalyse-Bericht erfolgreich abgerufen.
(Optional) Empfehlungen für Gelenkwinkel.
Das Datum des Ganganalyse-Berichts im Format TT/MM/JJJJ.
Ungültige Anfrage - Ungültiges Token oder Parameter.
Nicht autorisiert - Token ist ungültig oder abgelaufen.
Verboten - Admin-Zugriff erforderlich.
Nicht gefunden - Sitzung nicht gefunden oder Benutzer hat keinen gültigen Zahlungsplan.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Threads erfolgreich erstellt.
Ungültige Anfrage - Ungültiges Token oder Parameter.
Nicht autorisiert - Token ist ungültig oder abgelaufen.
Verboten - Admin-Zugriff erforderlich.
Nicht gefunden - Sitzung nicht gefunden oder Benutzer hat keinen gültigen Zahlungsplan.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um eine vorgefertigte Demo-Zusammenfassung für diese Lauf-Sitzung abzurufen.
Sitzungszusammenfassung erfolgreich abgerufen
Formatiertes Datum der Sitzung (z.B., '07/04/2025')
Ungültige Anfrage - Ungültiges Token oder Parameter.
Nicht autorisiert - Token ist ungültig oder abgelaufen.
Verboten - Admin-Zugriff erforderlich.
Nicht gefunden - Sitzung nicht gefunden oder Benutzer hat keinen gültigen Zahlungsplan.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Maßsystem: 'metric' oder 'imperial'
Zusammenfassungs-Threads erfolgreich generiert.
Ungültige Anfrage - Ungültiges Token oder Parameter.
Nicht autorisiert - Token ist ungültig oder abgelaufen.
Verboten - Admin-Zugriff erforderlich.
Nicht gefunden - Sitzung nicht gefunden oder Benutzer hat keinen gültigen Zahlungsplan.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
Zuletzt aktualisiert
War das hilfreich?