Springen
Dieser Endpunkt ermöglicht einem Administrator (oder Sub-Admin), eine Videodatei zur Verarbeitung hochzuladen und eine neue "Sitzungs"-Ressource im Namen eines anderen Benutzers zu erstellen. Der Server gibt eine session_id zurück, die zum Abfragen oder Abrufen der Sitzungsdetails/Ergebnisse verwendet werden kann.
Anfragekörper (Multipart/Form-Data)
Sie müssen folgende Felder angeben:
user_id (string, erforderlich): Die ID des Benutzers, für den diese Sitzung erstellt wird. - video (file, erforderlich): Die zu verarbeitende Videodatei. - session_name (string, optional): Ein lesbarer Name/Titel für die Sitzung. - exercise (string, erforderlich): Der Name der Übung. Wählen Sie eine der folgenden: 'Countermovement Jump' oder 'Drop Jump'. - body_joint_angles (array[string], optional): Eine kommagetrennte Liste von Gelenknamen (z.B. 'elbow, knee, ankle'). Standardmäßig ['all'], falls nicht angegeben.
Antwortstruktur
Bei Erfolg (HTTP 200) ist die Antwort ein JSON-Objekt mit: - session_id (string): Ein eindeutiger Identifikator für die erstellte Sitzung. - title (string): Der Sitzungstitel (Standardwert, falls session_name nicht angegeben wurde).
Ablauf 1. POST-Anfrage mit multipart/form-data, die die erforderlichen Felder user_id und video sowie optionale Felder enthält. 2. Einen gültigen API-KEY-Token im Authorization-Header bereitstellen. 3. Der Aufrufer muss Administratorrechte haben, um erfolgreich eine Sitzung für einen anderen Benutzer zu erstellen. 4. Bei Erfolg antwortet der Server mit session_id und title. 5. Bei einem Fehler (z.B. fehlende Felder, fehlende Berechtigungen) wird ein JSON-Objekt mit einem error-Schlüssel zurückgegeben.
Beispiel cURL (Firebase Auth): ```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 'exercise=Countermovement Jump' \
-F 'body_joint_angles=knee, ankle' \
https://<backend-link>/jumping/management/sessions/#### Beispiel cURL (API KEY): ```bash curl -X POST \
-H 'Content-Type: multipart/form-data' \
-H 'API-KEY: <YOUR_API_KEY>' \
-F 'user_id=someUserId123' \
-F 'video=@/path/to/video.mp4' \
-F 'session_name=Morning Run' \
-F 'exercise=Countermovement Jump' \
-F 'body_joint_angles=knee, ankle' \
https://<backend-link>/jumping/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).
Erforderlich. Der Name der Übung. Wählen Sie eine der folgenden: 'Countermovement Jump' oder 'Drop Jump'.
Optional. Eine kommagetrennte Liste von Gelenknamen. Verfügbare Werte: 'ankle', 'knee', 'elbow', 'hip', 'shoulder'. Beispiel: ankle,knee,hip
Video-Verarbeitungssitzung erfolgreich erstellt (HTTP 200).
Der eindeutige Identifikator 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 Administratorberechtigung, um Sitzungen für andere zu erstellen.
Nicht gefunden - Weist auf Geschäftslogikprobleme oder Ressourcenbeschränkungen hin (z.B. Sitzungslimit).
Interner Serverfehler - Unerwarteter Fehler auf dem Server aufgetreten.
POST /jumping/sessions/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 96
"user_id='text'&video='text'&session_name='text'&exercise='text'&body_joint_angles=[]"{
"session_id": "text",
"title": "text"
}Ruft detaillierte Informationen über eine bestimmte verarbeitete Sprung-Sitzung anhand ihrer eindeutigen session_id ab. Optional kann ?demo=true gesetzt werden, um die vordefinierte Demo-Sitzung für die Sprungaktivität abzurufen. Verwendungsbeispiel: Senden Sie eine GET-Anfrage mit der session_id als Pfadparameter, um Sitzungsdetails zu erhalten. Parameter: - session_id (string, erforderlich): Der eindeutige Identifikator der abgefragten Sitzung. - demo (boolean, optional): Auf true setzen, um die Demo-Sitzung für Sprung zurückzugeben. Antwortdatentyp: - 200 OK: Ein JSON-Objekt mit folgender Struktur:
angles(object): Enthalten Arrays verschiedener Winkelmessungen.whole_report_metrics(object): Enthalten Arrays verschiedener Metriken.all_timestamps(array of numbers): Zeitstempel für jeden Frame.analyzed_video_url(string, URI): URL des analysierten Videos.video_url(string, URI): URL des Originalvideos.created_at(object): Enthält Datum und Uhrzeit der Sitzungserstellung.exercise(string): Art der in der Sitzung analysierten Übung.user_name(string): Name des mit der Sitzung verknüpften Benutzers.activity(string): Art der in der Sitzung analysierten Aktivität.title(string): Titel der Sitzung.end_frames(array of integers): Frame-Nummern, bei denen jedes Segment endet.metrics(object): Enthält verschiedene Leistungsmetriken als Zahlenarrays.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um die Demo-Sitzung anstelle der echten abzurufen.
Sitzungsdaten erfolgreich abgerufen.
Array von Zeitstempeln für jeden Frame.
URL des analysierten Videos.
URL des Originalvideos.
Art der in der Sitzung analysierten Übung.
Name des mit der Sitzung verknüpften Benutzers.
Art der in der Sitzung analysierten Aktivität.
Titel der Sitzung.
Array von Frame-Nummern, bei denen jedes Segment endet.
Array aller Frame-Nummern, bei denen Segmente enden.
Ungültige Anfrage - Ungültige session_id angegeben.
Nicht autorisiert - Zugriffstoken fehlt oder ist ungültig.
Verboten - Benutzer hat nicht die erforderlichen Berechtigungen.
Nicht gefunden - Keine Sitzungsdaten für die angegebene session_id gefunden.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
GET /jumping/sessions/{session_id}/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"angles": {
"hip_intersection_angle": [
1
],
"ank_angle": [
1
],
"rkne_angle": [
1
],
"lkne_angle": [
1
],
"kne_angle": [
1
],
"rank_angle": [
1
],
"lank_angle": [
1
]
},
"whole_report_metrics": {
"hipy": [
1
],
"grf": [
1
],
"vhipy": [
1
],
"toey": [
1
],
"ahipy": [
1
],
"vtoey": [
1
]
},
"all_timestamps": [
1
],
"analyzed_video_url": "https://example.com",
"video_url": "https://example.com",
"created_at": {
"date": "2026-01-01",
"time": "00:00:00"
},
"exercise": "text",
"user_name": "text",
"activity": "text",
"title": "text",
"end_frames": [
1
],
"all_end_frames": [
1
],
"metrics": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
},
"all_metrics": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
}
}Ruft detaillierte Informationen über eine bestimmte Sprung-Sitzung anhand ihrer eindeutigen session_id ab. Optional kann ?demo=true gesetzt werden, um die vordefinierte Demo-Sitzung für die Sprungaktivität abzurufen. Hinweis: Dieser Endpunkt enthält Landmark-Punkte in der Antwort. Antwortdatentyp: - 200 OK: Ein JSON-Objekt mit folgender Struktur:
keypoints(object): Enthält Arrays von Landmark-Punkten.angles(object): Enthält Arrays verschiedener Winkelmessungen.all_timestamps(array of numbers): Zeitstempel für jeden Frame.analyzed_video_url(string, URI): URL des analysierten Videos.video_url(string, URI): URL des Originalvideos.created_at(object): Enthält Datum und Uhrzeit der Sitzungserstellung.user_name(string): Name des mit der Sitzung verknüpften Benutzers.activity(string): Art der analysierten Aktivität.title(string): Titel der Sitzung.end_frames(array of integers): Frame-Nummern, bei denen jedes Segment endet.metrics(object): Enthält verschiedene Leistungsmetriken als Zahlenarrays.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um die Demo-Sitzung anstelle der echten abzurufen.
Sitzungsdaten erfolgreich abgerufen.
Array von Zeitstempeln für jeden Frame.
URL des analysierten Videos.
URL des Originalvideos.
Name des mit der Sitzung verknüpften Benutzers.
Art der in der Sitzung analysierten Aktivität.
Titel der Sitzung.
Array von Frame-Nummern, bei denen jedes Segment endet.
Ungültige Anfrage - Ungültige session_id angegeben.
Nicht autorisiert - Zugriffstoken fehlt oder ist ungültig.
Verboten - Benutzer hat nicht die erforderlichen Berechtigungen.
Nicht gefunden - Keine Sitzungsdaten für die angegebene session_id gefunden.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
GET /jumping/sessions/{session_id}/export/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"keypoints": {
"lknev": [
1
],
"ltoev": [
1
],
"relbv": [
1
],
"rtoey": [
1
],
"headv": [
1
],
"rearv": [
1
],
"rshox": [
1
],
"etc": [
1
]
},
"angles": {
"hip_intersection_angle": [
1
],
"ank_angle": [
1
],
"rkne_angle": [
1
],
"lkne_angle": [
1
],
"kne_angle": [
1
],
"rank_angle": [
1
],
"lank_angle": [
1
]
},
"all_timestamps": [
1
],
"analyzed_video_url": "https://example.com",
"video_url": "https://example.com",
"created_at": {
"date": "2026-01-01",
"time": "00:00:00"
},
"user_name": "text",
"activity": "text",
"title": "text",
"end_frames": [
1
],
"metrics": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
}
}Vertikalen Sprunganalysebericht abrufen
Dieser Endpunkt ermöglicht Benutzern, einen umfassenden Analysebericht für eine bestimmte vertikale Sprung-Sitzung abzurufen. Der Bericht enthält grafische Daten, Phasendetails, Benutzerinformationen und zusätzliche Kommentare, um ein tiefgreifendes Verständnis der Benutzerleistung während der Sitzung zu ermöglichen. Verwendungsbeispiel: Senden Sie eine POST-Anfrage an /jumping/{session_id}/jump-analysis/, wobei {session_id} der eindeutige Identifikator der Sitzung ist. Parameter: - session_id (string, erforderlich): Der eindeutige Identifikator der Sitzung, für die der Bericht angefordert wird. - demo (boolean, optional): Auf true setzen, um den vordefinierten Demo-Bericht anstelle der echten Sitzung abzurufen. Antwortstruktur: Bei erfolgreicher Anfrage gibt der Endpunkt ein JSON-Objekt mit folgenden Abschnitten zurück: 1. Exercise: Der Name der während der Sitzung durchgeführten Übung. 2. Graph Data: Visuelle Darstellungen verschiedener während der Sitzung erfasster Metriken. 3. Frame Information: Details zu den Videoframes der Sitzung. 4. Phase Data: Informationen zu verschiedenen Phasen der vertikalen Sprungaktivität. 5. User Information: Persönliche Details des Benutzers. 6. Session Date: Das Datum der Sitzung. 7. Comments: Feedback und Kommentare basierend auf der Sitzungsleistung.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um den Demo-Bericht abzurufen.
Sprunganalysebericht erfolgreich abgerufen.
Für welche Übung dieser Bericht ist.
Minimale Frame-Nummer im Video.
Maximale Frame-Nummer im Video.
Datum der Sitzung (DD/MM/YYYY).
Ungültige Anfrage - Ungültige session_id angegeben.
Nicht autorisiert - Zugriffstoken fehlt oder ist ungültig.
Verboten - Benutzer hat nicht die erforderlichen Berechtigungen.
Nicht gefunden - Keine Sitzungsdaten für die angegebene session_id gefunden.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
POST /jumping/sessions/{session_id}/jump-analysis/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"exercise": "Countermovement Jump",
"graph_data": {
"hip_height": {
"ANY_ADDITIONAL_PROPERTY": {
"times": [
1
],
"data": [
1
]
}
},
"hip_speed": {
"ANY_ADDITIONAL_PROPERTY": {
"times": [
1
],
"data": [
1
]
}
},
"hip_trajectory": {
"ANY_ADDITIONAL_PROPERTY": {
"times": [
1
],
"data": [
1
]
}
},
"hip_velocity": {
"ANY_ADDITIONAL_PROPERTY": {
"times": [
1
],
"data": [
1
]
}
},
"toe_trajectory": {
"ANY_ADDITIONAL_PROPERTY": {
"times": [
1
],
"data": [
1
]
}
},
"grf": {
"ANY_ADDITIONAL_PROPERTY": {
"times": [
1
],
"data": [
1
]
}
},
"power": {
"ANY_ADDITIONAL_PROPERTY": {
"times": [
1
],
"data": [
1
]
}
},
"kne_angle": {
"ANY_ADDITIONAL_PROPERTY": {
"times": [
1
],
"data": [
1
]
}
},
"ank_angle": {
"ANY_ADDITIONAL_PROPERTY": {
"times": [
1
],
"data": [
1
]
}
},
"hip_angle": {
"ANY_ADDITIONAL_PROPERTY": {
"times": [
1
],
"data": [
1
]
}
}
},
"min_frame": 1,
"max_frame": 1,
"phase_data": {
"start_of_preparation": {
"video_frame": 1,
"graph_phase": 1,
"image_url": "https://example.com"
},
"braking": {
"video_frame": 1,
"graph_phase": 1,
"image_url": "https://example.com"
},
"zero_velocity": {
"video_frame": 1,
"graph_phase": 1,
"image_url": "https://example.com"
},
"takeoff": {
"video_frame": 1,
"graph_phase": 1,
"image_url": "https://example.com"
},
"peak": {
"video_frame": 1,
"graph_phase": 1,
"image_url": "https://example.com"
},
"landing": {
"video_frame": 1,
"graph_phase": 1,
"image_url": "https://example.com"
},
"damping": {
"video_frame": 1,
"graph_phase": 1,
"image_url": "https://example.com"
},
"recuperation": {
"video_frame": 1,
"graph_phase": 1,
"image_url": "https://example.com"
}
},
"user_information": {
"name": "text",
"age": 1,
"weight": 1,
"height": 1,
"gender": "text"
},
"session_date": "2026-01-01",
"comments": {
"power": "text",
"grf": "text"
}
}Empfehlungs-Threads erstellen
Dieser Endpunkt generiert personalisierte Empfehlungs-Threads basierend auf dem vertikalen Sprunganalysebericht eines Benutzers für eine bestimmte Sitzung. Diese Threads können verwendet werden, um dem Benutzer maßgeschneiderte Ratschläge, Trainingsvorschläge oder Leistungseinblicke zu bieten. Verwendungsbeispiel: Senden Sie eine POST-Anfrage an /jumping/sessions/{session_id}/recommendation/, wobei {session_id} der eindeutige Identifikator der Sitzung ist. Parameter: - session_id (string, erforderlich): Der eindeutige Identifikator der Sitzung, für die Empfehlungs-Threads erstellt werden sollen. Antwortstruktur: Bei erfolgreicher Anfrage gibt der Endpunkt ein JSON-Objekt zurück, das Thread-IDs ihren jeweiligen Metriken zuordnet. Hinweis: - Stellen Sie sicher, dass die angegebene session_id gültig ist und einer vorhandenen Sitzung im System entspricht. - Der Benutzer muss einen aktiven Zahlungsplan haben, um auf diese Funktion zugreifen zu können.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Threads erfolgreich erstellt.
Zuordnung von Metriknamen zu Empfehlungs-Thread-IDs.
Thread-ID für Hüfthöhen-Empfehlungen.
Thread-ID für Hüftgeschwindigkeits-Empfehlungen.
Thread-ID für Hüfttrajektorie-Empfehlungen.
Thread-ID für Hüftgeschwindigkeits-Empfehlungen.
Thread-ID für Zehentrajektorie-Empfehlungen.
Thread-ID für Bodenreaktionskraft (GRF)-Empfehlungen.
Thread-ID für Leistungs-Empfehlungen.
Thread-ID für Kniewinkel-Empfehlungen.
Thread-ID für Knöchelwinkel-Empfehlungen.
Thread-ID für Hüftwinkel-Empfehlungen.
Ungültige Anfrage - Ungültige session_id angegeben.
Nicht autorisiert - Zugriffstoken fehlt oder ist ungültig.
Verboten - Benutzer hat nicht die erforderlichen Berechtigungen.
Nicht gefunden - Keine Sitzungsdaten für die angegebene session_id gefunden.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
POST /jumping/sessions/{session_id}/recommendation/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"hip_height": "text",
"hip_speed": "text",
"hip_trajectory": "text",
"hip_velocity": "text",
"toe_trajectory": "text",
"grf": "text",
"power": "text",
"kne_angle": "text",
"ank_angle": "text",
"hip_angle": "text"
}Sitzungszusammenfassung abrufen
Dieser Endpunkt liefert eine Zusammenfassung einer bestimmten Sitzung, einschließlich wichtiger Leistungsmetriken, Benutzerdaten und Sitzungserstellungsdetails. Verwendungsbeispiel: Senden Sie eine GET-Anfrage an /jumping/{session_id}/summary/, wobei {session_id} die eindeutige Sitzungs-ID ist. Abfrageparameter: - demo (boolean, optional): Auf true setzen, um eine vorgefertigte Demo-Zusammenfassung anstelle einer echten Sitzung abzurufen. Antwortstruktur: - exercise: Art der zusammengefassten Übung. - metrics: Enthält verschiedene Messungen der Sitzung. - summary: Beschreibende Übersicht der Leistung. - user_info: Grundlegende Informationen über den Benutzer. - session_date: Datum der Sitzungsaufzeichnung. Hinweis: Stellen Sie sicher, dass die session_id existiert. Wenn demo=true verwendet wird, gibt das System die vordefinierte Demo-Sitzungszusammenfassung zurück.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um die Demo-Sitzungszusammenfassung anstelle einer echten abzurufen.
Sitzungszusammenfassung erfolgreich abgerufen.
Objekt mit Sitzungszusammenfassungsdetails.
Art der zusammengefassten Übung.
Ungültige Anfrage - Ungültige session_id angegeben.
Nicht autorisiert - Zugriffstoken fehlt oder ist ungültig.
Verboten - Benutzer hat nicht die erforderlichen Berechtigungen.
Nicht gefunden - Keine Sitzungsdaten für die angegebene session_id gefunden.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
GET /jumping/sessions/{session_id}/summary/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"exercise": "text",
"metrics": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
},
"summary": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"user_info": {
"name": "text",
"age": 1,
"weight": 1,
"height": 1,
"gender": "text"
},
"created_at": {
"date": "2026-01-01",
"time": "00:00:00"
}
}Zusammenfassungs-Threads generieren
Dieser Endpunkt generiert Zusammenfassungs-Threads für eine gegebene Sitzung basierend auf vordefinierten Zusammenfassungsblöcken und Metriken. Verwendungsbeispiel: Senden Sie eine POST-Anfrage an /jumping/sessions/{session_id}/summary/, wobei {session_id} der eindeutige Identifikator der Sitzung ist. Parameter: - session_id (string, erforderlich): Der eindeutige Identifikator der Sitzung, für die Zusammenfassungs-Threads generiert werden sollen. - measurement_system (string, optional): Messsystem: 'metric' oder 'imperial'. Standard: 'metric'. Antwortstruktur: Bei erfolgreicher Anfrage gibt der Endpunkt ein JSON-Objekt zurück, das jeden Blocknamen seiner entsprechenden Thread-ID zuordnet. Hinweis: - Stellen Sie sicher, dass die angegebene session_id gültig ist und einer vorhandenen Sitzung im System entspricht. - Der Benutzer muss die erforderlichen Berechtigungen haben, um Zusammenfassungs-Threads zu generieren.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Messsystem: 'metric' oder 'imperial'
Zusammenfassungs-Threads erfolgreich generiert.
Wörterbuch, das Blocknamen ihren entsprechenden Thread-IDs zuordnet, einschließlich eines abschließenden Zusammenfassungs-Threads.
Thread-ID entsprechend dem Blocknamen.
Ungültige Anfrage - Ungültige session_id angegeben.
Nicht autorisiert - Zugriffstoken fehlt oder ist ungültig.
Verboten - Benutzer hat nicht die erforderlichen Berechtigungen.
Nicht gefunden - Keine Sitzungsdaten für die angegebene session_id gefunden.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
POST /jumping/sessions/{session_id}/summary/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"ANY_ADDITIONAL_PROPERTY": "text"
}Zuletzt aktualisiert
War das hilfreich?