Mobilitätsbewertung
Ruft Details einer bestimmten Mobility Assessment-Sitzung anhand ihrer session_id ab. Dieser Endpunkt gibt Informationen wie die Anzahl der Segmente, Video-URLs, Winkeldaten, Zeitstempel und andere Sitzungsmetadaten zurück.
Pfadparameter
session_id (string, erforderlich): Eindeutiger Identifikator der Mobility Assessment-Sitzung.
Abfrageparameter
demo (boolean, optional): Auf
truesetzen, um die vorgefertigte Demo-Sitzung abzurufen.
Erfolgreiche Antwort (HTTP 200)
Ein JSON-Objekt mit:
segments (integer): Die Gesamtzahl der Segmente in dieser Mobility Assessment.
video_url (string, URI): URL des ursprünglich hochgeladenen Videos.
analyzed_video_url (string, URI, optional): URL des analysierten (verarbeiteten) Videos.
activity (string): Die Art der Aktivität, z.B.
Mobility Assessment.title (string): Titel oder Name der Sitzung.
user_name (string): Name des mit der Sitzung verknüpften Benutzers.
created_at (object): Ein Objekt mit
dateundtimefür die Erstellung der Sitzung.date (string): Format
DD/MM/YYYY.time (string): Format
HH:MM AM/PM.
exercise (string): Der Übungsname oder -typ (z.B.
Overhead Squad).angles (object): Ein Objekt mit relevanten Winkeldaten für die Mobility Assessment.
hip_angle (array of numbers): Beispielarray von Hüftwinkeln.
ankle_angle (array of numbers): Beispielarray von Knöchelwinkeln.
... (weitere Winkelparameter nach Bedarf)
all_timestamps (array of numbers): Array von Zeitstempeln, die den Winkeldaten entsprechen.
Fehlerantworten
400 Bad Request: Ungültige oder fehlende Parameter.
401 Unauthorized: Fehlender oder ungültiger Authentifizierungstoken.
403 Forbidden: Benutzer hat keine Berechtigung, diese Sitzung abzurufen.
404 Not Found: Sitzung nicht gefunden.
500 Internal Server Error: Unerwarteter Fehler auf dem Server.
Ein gültiger API-KEY Token muss im Authorization-Header angegeben werden.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um die vorgefertigte Demo-Sitzung abzurufen.
Mobility Assessment-Sitzungsdaten erfolgreich abgerufen.
Anzahl der Segmente in dieser Mobility Assessment.
URL des ursprünglichen Videos.
Optionale URL des verarbeiteten Videos.
Art der Aktivität, z.B. 'Mobility Assessment'.
Ein benutzerfreundlicher Sitzungstitel.
Name des mit dieser Sitzung verknüpften Benutzers.
Der Übungsname, z.B. 'Overhead Squad'.
Array von numerischen Zeitstempeln, die jedem Winkeldateneintrag entsprechen.
Ungültige Anfrage - Ungültige oder fehlende Parameter.
Nicht autorisiert - Fehlender oder ungültiger Authentifizierungstoken.
Verboten - Der Benutzer hat keine Berechtigung, diese Sitzung abzurufen.
Nicht gefunden - Die Sitzung wurde nicht gefunden oder existiert nicht.
Interner Serverfehler - Unerwarteter Fehler auf dem Server.
GET /mobility-assessment/sessions/{session_id}/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"segments": 1,
"video_url": "https://example.com",
"analyzed_video_url": "https://example.com",
"activity": "text",
"title": "text",
"user_name": "text",
"created_at": {
"date": "text",
"time": "text"
},
"exercise": "text",
"angles": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
},
"all_timestamps": [
1
]
}Generiert einen zusammengefassten Gelenkwinkel-Mobilitätsbericht für eine gegebene session_id.
Pfadparameter
session_id (string, erforderlich): Die eindeutige Kennung der Mobilitätssitzung.
Erfolgreiche Antwort (HTTP 200)
Gibt ein JSON-Objekt zurück mit:
title (string): Der Titel der Sitzung. - angles (object): Schlüssel sind Gelenknamen, Werte sind:
max (number|null)
min (number|null)
values (array[number])
exercise (string): Immer
Gelenkwinkel-Mobilität. - user_info (object): Benutzerdetails. - date (string): Formatierter Datum (TT/MM/JJJJ). - uploaded_date (string, date-time): Roh-ISO-Zeitstempel. - shown_angles (array[string]): Welche Winkel angezeigt werden sollen. - comments (object[string → string]): Kommentare pro Winkel.
Fehlerantworten
400 Bad Request: Ungültiger Sitzungstyp oder Parameter. - 404 Not Found: Sitzung nicht gefunden. - 500 Internal Server Error: Unerwarteter Serverfehler. Erfordert einen gültigen API-KEY-Token im
Authorization-Header.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Gelenkwinkel-Mobilitätsbericht erfolgreich abgerufen.
Sitzungstitel
Übungsname, 'Gelenkwinkel-Mobilität'
Sitzungsdatum im TT/MM/JJJJ-Format
Roh-ISO-Zeitstempel des Uploads
Vom Benutzer ausgewählte anzuzeigende Winkel
Ungültige Anfrage - Ungültiger Übungstyp oder Parameter.
Verboten - Unzureichende Berechtigungen zum Abrufen der Sitzungsdaten.
Nicht gefunden - Sitzungsdaten nicht gefunden.
Interner Serverfehler - Unerwarteter Fehler aufgetreten.
POST /mobility-assessment/sessions/{session_id}/joint-mobility/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"title": "text",
"angles": {
"ANY_ADDITIONAL_PROPERTY": {
"max": 1,
"min": 1,
"values": [
1
]
}
},
"exercise": "text",
"user_info": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"date": "text",
"uploaded_date": "2026-01-01T00:00:00.000Z",
"shown_angles": [
"text"
],
"comments": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
}Exportiert Landmarken- und Winkeldaten für eine bestimmte Mobility Assessment-Sitzung. Dieser Endpunkt gibt minimale Metadaten zurück, einschließlich nur activity, angles, all_timestamps und keypoints mit verschiedenen Arrays von Landmarkenpunkten.
Pfadparameter
session_id (string, erforderlich): Der eindeutige Identifikator der Sitzung.
Abfrageparameter
demo (boolean, optional): Auf
truesetzen, um Demo-Sitzungsdaten abzurufen.
Erfolgreiche Antwort (HTTP 200)
Ein JSON-Objekt mit:
activity (string): Die Art der Aktivität (z.B. 'Mobility Assessment').
angles (object): Ein Objekt mit relevanten Winkeldaten für die Mobility Assessment.
hip_angle (array of numbers): Beispielarray von Hüftwinkeln.
ankle_angle (array of numbers): Beispielarray von Knöchelwinkeln.
... (weitere Winkelparameter nach Bedarf)
all_timestamps (array of numbers): Array von Zeitstempeln für jeden Datenpunkt.
keypoints (object): Enthält Arrays von Landmarkenpunkten. Beispiele:
lknev (array of numbers): Array von linken Knie-Landmarkenpunkten.
ltoev (array of numbers): Array von linken Zehen-Landmarkenpunkten.
relbv (array of numbers): Array von rechten Ellenbogen-Landmarkenpunkten.
rtoey (array of numbers): Array von rechten Zehen-Landmarkenpunkten.
headv (array of numbers): Array von Kopf-Landmarkenpunkten.
rearv (array of numbers): Array von rechten Ohr-Landmarkenpunkten.
rshox (array of numbers): Array von rechten Schulter-Landmarkenpunkten.
etc (array of numbers): Array aller anderen Landmarkenpunkten.
Fehlerantworten
400 Bad Request: Ungültige oder fehlende Parameter.
401 Unauthorized: Fehlender oder ungültiger Authentifizierungstoken.
403 Forbidden: Unzureichende Berechtigungen zum Abrufen dieser Daten.
404 Not Found: Die Sitzung existiert nicht.
500 Internal Server Error: Unerwarteter Fehler auf dem Server.
Ein gültiger API-KEY Token muss im Authorization-Header angegeben werden.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um Demo-Sitzungsdaten abzurufen.
Sitzungsdaten erfolgreich exportiert.
Art der Aktivität (z.B. 'Mobility Assessment').
Array von numerischen Zeitstempeln für jeden Datenpunkt.
Ungültige Anfrage - Möglicherweise aufgrund ungültiger oder fehlender session_id.
Nicht autorisiert - Fehlender oder ungültiger Authentifizierungstoken.
Verboten - Unzureichende Berechtigungen zum Abrufen der Sitzungsdaten.
Nicht gefunden - Die Sitzung existiert nicht.
Interner Serverfehler - Unerwarteter Fehler auf dem Server.
GET /mobility-assessment/sessions/{session_id}/export/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"activity": "text",
"angles": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
},
"all_timestamps": [
1
],
"keypoints": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
}
}Dieser Endpunkt ermöglicht es einem Admin (oder Sub-Admin), eine Videodatei zur Verarbeitung hochzuladen und eine neue "Sitzung"-Ressource im Namen eines anderen Benutzers (Mobility Assessment) 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)
Folgende Felder müssen angegeben werden:
user_id (string, erforderlich): Die ID des Benutzers, für den diese Sitzung erstellt wird.
video (file, erforderlich): Die rohe Videodatei, die verarbeitet werden soll.
session_name (string, optional): Ein lesbarer Name/Titel für die Sitzung.
exercise_name (string, erforderlich): Der Name der durchzuführenden Übung. Wählen Sie eine der folgenden:
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_namenicht angegeben wurde).
Ablauf
POST eine multipart/form-data Anfrage mit den erforderlichen Feldern
user_idundvideosowie optionalen Feldern.Geben Sie einen gültigen API-KEY Token im
Authorization-Header an.Der Aufrufer muss Admin-Rechte haben, um erfolgreich eine Sitzung für einen anderen Benutzer zu erstellen.
Bei Erfolg antwortet der Server mit
session_idundtitle.Bei einem Fehler (z.B. fehlende Felder, fehlende Berechtigungen) wird ein JSON-Objekt mit einem
error-Schlüssel zurückgegeben.
Beispiel cURL:
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 rohe Videodatei, die verarbeitet werden soll (Formularfeldtyp: file).
Optional. Ein beschreibender Name für die Sitzung (Formularfeld: Text).
Erforderlich. Der Name der Übung. Wählen Sie eine der folgenden: 'Overhead Squat', 'Joint Angle Mobility'
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 Admin-Berechtigung, um Sitzungen für andere zu erstellen.
Nicht gefunden - Zeigt Geschäftslogikprobleme oder Ressourcenbeschränkungen an (z.B. Sitzungslimit).
Interner Serverfehler - Unerwarteter Fehler auf dem Server.
POST /mobility-assessment/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"
}Gibt die aktuellen Anzeigeeinstellungen für die angegebene Joint Angle Mobility-Sitzung zurück.
Pfadparameter
session_id(string, erforderlich): Identifikator der abzufragenden Sitzung.
Antworten
200 OK: Konfiguration wurde gefunden und zurückgegeben.
shown_angles: Array von ausgewählten Gelenkwinkelschlüsseln.comments: Map mit freien Notizen, nach Winkeln sortiert.
401 Unauthorized: Keine gültigen Authentifizierungsdaten angegeben.
403 Forbidden: Sie dürfen die Einstellungen dieser Sitzung nicht einsehen.
404 Not Found: Die Sitzungs-ID entspricht keiner gespeicherten Konfiguration.
500 Internal Server Error: Unerwarteter Fehler auf dem Server.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Konfiguration erfolgreich abgerufen.
Ausgewählte Gelenkwinkelschlüssel
Nicht autorisiert – Authentifizierungsdaten fehlen oder sind ungültig.
Verboten – Sie haben keine Berechtigung, diese Konfiguration einzusehen.
Nicht gefunden – Keine Berichtskonfiguration für diese Sitzung vorhanden.
Interner Serverfehler – Etwas ist auf unserer Seite schiefgelaufen.
GET /mobility-assessment/sessions/{session_id}/joint-mobility-config/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"shown_angles": [
"knee_angle",
"hip_angle"
],
"comments": {
"knee_angle": "Beugung auf Ausrichtung prüfen."
}
}Speichert Ihre gewählten Anzeigeeinstellungen für die angegebene Joint Angle Mobility-Sitzung.
Pfadparameter
session_id(string, erforderlich): Sitzungsidentifikator.
Anfragekörper
shown_angles(array[string], optional): Gelenkwinkelschlüssel, die angezeigt werden sollen.comments(object[string→string], optional): Notizen pro Winkel.
Antworten
200 OK: Konfiguration erfolgreich gespeichert (gibt die gespeicherten Einstellungen zurück).
400 Bad Request: Ein oder mehrere Felder waren ungültig — siehe
errorsfür Details.401 Unauthorized: Keine gültigen Authentifizierungsdaten angegeben.
403 Forbidden: Sie dürfen die Einstellungen dieser Sitzung nicht ändern.
500 Internal Server Error: Unerwarteter Fehler beim Speichern.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Anzuzeigende Winkel
["shoulder_angle","ankle_angle"]Konfiguration gespeichert und zurückgegeben.
Aktualisierte Liste der angezeigten Winkel
Ungültige Anfrage – Validierung für ein oder mehrere Felder fehlgeschlagen.
Nicht autorisiert – Authentifizierungsdaten fehlen oder sind ungültig.
Verboten – Sie haben keine Berechtigung, diese Konfiguration zu ändern.
Interner Serverfehler – Etwas ist beim Speichern Ihrer Daten schiefgelaufen.
POST /mobility-assessment/sessions/{session_id}/joint-mobility-config/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 100
{
"shown_angles": [
"hip_angle",
"knee_angle"
],
"comments": {
"hip_angle": "Bewegungsbereich überwachen."
}
}{
"shown_angles": [
"hip_angle",
"knee_angle"
],
"comments": {
"hip_angle": "Bewegungsbereich verbessert."
}
}Empfehlungsthreads erstellen
Dieser Endpunkt generiert personalisierte Empfehlungsthreads basierend auf dem Overhead-Squat-Bericht des Benutzers für eine bestimmte Sitzung. Diese Threads können verwendet werden, um dem Benutzer maßgeschneiderte Ratschläge, Trainingsvorschläge oder Leistungs- einblicke zu bieten. Beispielnutzung: Senden Sie eine POST-Anfrage an /mobility-assessment/sessions/{session_id}/recommendation/, wobei {session_id} die eindeutige Kennung der Sitzung ist. Parameter:
session_id(string, erforderlich): Die eindeutige Kennung der Sitzung, für die Empfehlungsthreads erstellt werden sollen. Antwortstruktur: Bei einer erfolgreichen Anfrage gibt der Endpunkt ein JSON-Objekt zurück, das Thread-IDs den jeweiligen Metriken aus dem Overhead-Squat-Bericht zuordnet. Beispielantwort:
"ankle_dorsiflexion": "thread_boQ0PSivWvPHIx4MQ02HqSEX",
"hip_abduction": "thread_eoTqfX3qWuT2IrEhZpGcem7L",
"hip_flexion": "thread_0pJjWIs5ybuo5gzRJd1ykgaB",
"knee_flexion": "thread_8gp2spSn8XasAOafDwwzw5QT",
"knee_movement": "thread_8gp2spSn8XasAOafDwwzw5QT",
"final_summary": "thread_P3MqG76m9s6qlYwINJrlNomB"
} ```
**Hinweis:**
- Stellen Sie sicher, dass die angegebene `session_id` gültig ist und einer bestehenden Sitzung im System entspricht. - Der Benutzer muss einen aktiven Zahlungsplan haben, um diese Funktion nutzen zu können.Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Threads erfolgreich erstellt.
Ein Wörterbuch, das jede Metrik ihrer entsprechenden Thread-ID zuordnet.
Eindeutige Kennung für den Sprunggelenks-Dorsalflexions-Empfehlungsthread.
Eindeutige Kennung für den Hüftabduktions-Empfehlungsthread.
Eindeutige Kennung für den Hüftflexions-Empfehlungsthread.
Eindeutige Kennung für den Kniebeugungs-Empfehlungsthread.
Eindeutige Kennung für den Kniebewegungs-Empfehlungsthread.
Eindeutige Kennung für den zusammenfassenden Empfehlungsthread.
Nicht autorisiert - Fehlender oder ungültiger Token.
Verboten - Ungültiger Zahlungsplan oder unzureichende Berechtigungen zum Erstellen von Empfehlungsthreads.
Nicht gefunden - Sitzung nicht gefunden oder Metriken fehlen.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
POST /mobility-assessment/sessions/{session_id}/recommendation/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"ankle_dorsiflexion": "text",
"hip_abduction": "text",
"hip_flexion": "text",
"knee_flexion": "text",
"knee_movement": "text",
"final_summary": "text"
}Generiert oder ruft einen detaillierten Overhead-Squat-Bericht für eine gegebene session_id ab. Dieser Endpunkt konsolidiert Sitzungsmetriken, organisiert sie in Gruppen und fügt Benutzer- und Sitzungsmetadaten ein.
Pfadparameter
session_id (string, erforderlich): Die eindeutige Kennung der Overhead-Squat-Sitzung.
Abfrageparameter
demo (boolean, optional): Auf
truesetzen, um den Demo-Overhead-Squat-Bericht anstelle eines echten abzurufen.
Erfolgreiche Antwort (HTTP 200)
Gibt ein JSON-Objekt zurück mit:
grouped_data (object): Nach Metrikengruppen organisiert (z.B.
hip_flexion,knee_flexion). Jede Gruppe hat:metrics (object): Schlüssel-Wert-Paare aggregierter Metrikergebnisse.
graph_data (object): Arrays numerischer Daten zur Diagrammerstellung.
graph_timestamps (array[number]): Liste von Zeitstempeln (in Millisekunden) für jede Diagrammdaten. - knee_movement_phases (object): URLs von Visualisierungsbildern, die verschiedene Ansichten der Kniebewegungsphasen zeigen.
left (string): URL für das Bild der linken Ansicht.
right (string): URL für das Bild der rechten Ansicht.
front (string): URL für das Bild der Frontansicht.
user_info (object, optional): Grundlegende Benutzerdetails der Sitzung. - exercise (string): Der Übungsname/-typ (z.B.
Overhead Squat). - report_comments (object, optional): Detailliertes Feedback zu verschiedenen Bewegungsaspekten. - output_quality (object, optional): Zusätzliche Qualitäts- oder Bewertungsinformationen. - date (string, format=TT/MM/JJJJ): Das Erstellungs- oder Verarbeitungsdatum der Sitzung.
Beispiel für eine erfolgreiche Antwort
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um den Demo-Overhead-Squat-Bericht anstelle eines echten abzurufen.
Overhead-Squat-Bericht erfolgreich generiert/abgerufen.
Eine Liste von Zeitstempeln (in Millisekunden) für jede Diagrammdaten.
Name/Typ der Übung (z.B. 'Overhead Squat').
Eine Zeichenkette, die das Sitzungsdatum im TT/MM/JJJJ-Format darstellt.
Nicht autorisiert - Fehlender oder ungültiger Zugriffstoken.
Verboten - Der Benutzer hat keine Berechtigung zum Erstellen von Sitzungen (nur Admins).
Nicht gefunden - Sitzungsdaten können nicht gefunden werden oder keine Metriken zurückgegeben.
Interner Serverfehler - Unerwarteter Fehler aufgetreten.
POST /mobility-assessment/sessions/{session_id}/report/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"grouped_data": {
"ANY_ADDITIONAL_PROPERTY": {
"metrics": {
"ANY_ADDITIONAL_PROPERTY": 1
},
"graph_data": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
}
}
},
"graph_timestamps": [
1
],
"knee_movement_phases": {
"left": "text",
"right": "text",
"front": "text"
},
"user_info": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"exercise": "text",
"output_quality": {
"ANY_ADDITIONAL_PROPERTY": 1
},
"report_comments": {
"hip_flexion": "text",
"ankle_dorsiflexion": "text",
"final_summary": "text",
"hip_abduction": "text"
},
"date": "text"
}Ruft eine hochrangige Zusammenfassung der Overhead-Squat-Sitzungsdaten ab, die durch ihre session_id identifiziert werden. Dieser Endpunkt gibt gruppierte Metriken (z.B. hip_flexion, knee_flexion) ohne detaillierte Diagrammdaten zurück, sowie optionale Benutzer- und Sitzungsmetadaten.
Pfadparameter
session_id (string, erforderlich): Die eindeutige Kennung der Overhead-Squat-Sitzung.
Abfrageparameter
demo (boolean, optional): Auf
truesetzen, um die vorgefertigte Demo-Overhead-Squat-Zusammenfassung anstelle einer echten abzurufen.
Erfolgreiche Antwort (HTTP 200)
Gibt ein JSON-Objekt zurück mit:
grouped_data (object): Hochrangige Metriken nach Kategorie gruppiert (z.B. hip_flexion, knee_flexion). Jede Gruppe enthält Metrikschlüssel, die numerischen Werten zugeordnet sind. - knee_movement_phases (object): URLs von Visualisierungsbildern, die verschiedene Ansichten der Kniebewegungsphasen zeigen.
left (string): URL für das Bild der linken Ansicht.
right (string): URL für das Bild der rechten Ansicht.
front (string): URL für das Bild der Frontansicht.
user_info (object, optional): Enthält benutzerbezogene Felder, z.B. Gewicht, display_name, E-Mail. - exercise (string): Der Übungsname (z.B.
Overhead Squat). - output_quality (object, optional): Enthält numerische Werte oder Indizes (z.B. mobility_index). - summary (object, optional): Enthält detailliertes Feedback zu verschiedenen Bewegungsaspekten. - date (string, format=TT/MM/JJJJ): Das Erstellungs-/Verarbeitungsdatum dieser Sitzung.
Beispiel für eine erfolgreiche Antwort
"grouped_data": {
"hip_flexion": {
"left_hip_flexion": 84.0,
"right_hip_flexion": 80.0,
"hip_flexion_asymmetry": 4.0
},
"hip_adduction": {
"left_hip_abduction": 9.0,
"right_hip_abduction": 16.0,
"hip_abduction_asymmetry": 7.0
},
"knee_flexion": {
"left_knee_flexion": 79.0,
"right_knee_flexion": 82.0,
"knee_flexion_asymmetry": 3.0
},
"ankle_dorsiflexion": {
"left_ankle_flexion": 9.0,
"right_ankle_flexion": 15.0,
"ankle_flexion_asymmetry": 6.0
}
},
"knee_movement_phases": {
"left": "https://storage.googleapis.com/aikonweb001.appspot.com/report-images/.../left.png",
"right": "https://storage.googleapis.com/aikonweb001.appspot.com/report-images/.../right.png",
"front": "https://storage.googleapis.com/aikonweb001.appspot.com/report-images/.../front.png"
},
"user_info": {
"display_name": "Natalia Alioth",
"weight": 70.0,
"email": "natalia3@gmail.com",
...
},
"exercise": "Overhead Squat",
"output_quality": {
"mobility_index": 46.0,
"quality_index": 67.0
},
"summary": {
"hip_flexion": "Für eine optimale Verbesserung der Hüftbeugung konzentrieren Sie sich auf dynamische Dehn- und Mobilitätsübungen.",
"ankle_dorsiflexion": "Natalia, Ihre linke Sprunggelenksdorsalflexion beträgt 9,0 Grad...",
"final_summary": "Natalia, Ihre Knie- und Hüftbeugungsmetriken sind stark...",
"hip_abduction": "Für eine optimale Hüftabduktionsleistung konzentrieren Sie sich auf die Verbesserung..."
},
"date": "11/03/2025"
} ```
**Fehlerbehandlung**
- **401 Unauthorized**: Fehlender oder ungültiger Token. - **403 Forbidden**: Der Zahlungsplan ist nicht gültig (Basic, Standard, Pro oder Enterprise erforderlich) oder der Benutzer hat keine Berechtigungen. - **404 Not Found**: Sitzungsdaten wurden nicht gefunden oder Metriken fehlen. - **500 Internal Server Error**: Unerwarteter Serverfehler.
Ein gültiger API-KEY-Token muss im `Authorization`-Header bereitgestellt werden.Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um die vorgefertigte Demo-Overhead-Squat-Zusammenfassung anstelle einer echten abzurufen.
Overhead-Squat-Zusammenfassung erfolgreich abgerufen.
Der Übungsname/-typ, z.B. 'Overhead Squat'.
Sitzungsdatum im 'TT/MM/JJJJ'-Format.
Nicht autorisiert - Fehlender oder ungültiger Token.
Verboten - Ungültiger Zahlungsplan oder unzureichende Berechtigungen zum Abrufen der Zusammenfassung.
Nicht gefunden - Sitzung nicht gefunden oder Metriken fehlen.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
GET /mobility-assessment/sessions/{session_id}/summary/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"grouped_data": {
"ANY_ADDITIONAL_PROPERTY": {
"ANY_ADDITIONAL_PROPERTY": 1
}
},
"knee_movement_phases": {
"left": "text",
"right": "text",
"front": "text"
},
"user_info": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"exercise": "text",
"output_quality": {
"ANY_ADDITIONAL_PROPERTY": 1
},
"summary": {
"hip_flexion": "text",
"ankle_dorsiflexion": "text",
"final_summary": "text",
"hip_abduction": "text"
},
"date": "text"
}Zusammenfassungsthreads generieren
Dieser Endpunkt generiert Zusammenfassungsthreads für eine gegebene Sitzung basierend auf vordefinierten Zusammenfassungsblöcken und Metriken. Beispielnutzung: Senden Sie eine POST-Anfrage an /mobility-assessment/sessions/{session_id}/summary/, wobei {session_id} die eindeutige Kennung der Sitzung ist. Parameter:
session_id(string, erforderlich): Die eindeutige Kennung der Sitzung, für die Zusammenfassungsthreads generiert werden sollen. Antwortstruktur: Bei einer erfolgreichen Anfrage gibt der Endpunkt ein JSON-Objekt zurück, das jede Metrik ihrer entsprechenden Thread-ID zuordnet. Beispielantwort:
"hip_flexion": "thread_x7C4p5ancmeluBmEJgmFwXra",
"hip_abduction": "thread_lth8oxKfnktwne9ryGZefd6V",
"knee_flexion": "thread_cM4jY2RLfVNeFIImJXaIinMK",
"knee_movement": "thread_8gp2spSn8XasAOafDwwzw5QT",
"ankle_dorsiflexion": "thread_EIwgj822ZHtGCTMucHZDtatH",
"final_summary": "thread_2XwSNDNrclHgakiBFm4o9K65"
} ```
**Hinweise:**
- Stellen Sie sicher, dass die angegebene `session_id` gültig ist und einer bestehenden Sitzung im System entspricht. - Der Benutzer muss die erforderlichen Berechtigungen haben, um Zusammenfassungsthreads zu generieren.Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Messsystem: 'metric' oder 'imperial'
Zusammenfassungsthreads erfolgreich generiert.
Wörterbuch, das jede Metrik ihrer entsprechenden Thread-ID zuordnet.
Eindeutige Kennung für den Hüftbeugungs-Zusammenfassungsthread.
Eindeutige Kennung für den Hüftabduktions-Zusammenfassungsthread.
Eindeutige Kennung für den Kniebeugungs-Zusammenfassungsthread.
Eindeutige Kennung für den Kniebewegungs-Zusammenfassungsthread.
Eindeutige Kennung für den Sprunggelenksdorsalflexions-Zusammenfassungsthread.
Eindeutige Kennung für den abschließenden Zusammenfassungsthread.
Nicht autorisiert - Fehlender oder ungültiger Token.
Verboten - Ungültiger Zahlungsplan oder unzureichende Berechtigungen zum Erstellen von Empfehlungsthreads.
Nicht gefunden - Sitzung nicht gefunden oder Metriken fehlen.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
POST /mobility-assessment/sessions/{session_id}/summary/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"hip_flexion": "text",
"hip_abduction": "text",
"knee_flexion": "text",
"knee_movement": "text",
"ankle_dorsiflexion": "text",
"final_summary": "text"
}Zuletzt aktualisiert
War das hilfreich?