Gewichtheben
Anfragekörper (Multipart/Form-Data)
Antwortstruktur
Ablauf
-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_name=clean' \
-F 'barbell_mass=30' \
-F 'body_joint_angles=elbow, knee, ankle' \
https://<backend-link>/weightlifting/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 Optionen: "snatch", "clean" oder "clean_and_jerk".
Optional. Die Masse der Hantel (numerische Zeichenkette). Standardwert: 100 kg (oder 220 lb), falls nicht angegeben.
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 ID der erstellten Sitzung.
Der Sitzungstitel (Standardwert, falls nicht angegeben).
Ungültige Anfrage - Möglicherweise fehlende user_id, fehlende video oder ungültige Formulardaten.
Nicht autorisiert - Fehlender oder ungültiger Zugriffstoken.
Verboten - Der Benutzer hat keine Administratorberechtigung, um Sitzungen für andere zu erstellen.
Nicht gefunden - Geschäftslogikprobleme oder Ressourcenbeschränkungen (z.B. Sitzungslimit).
Interner Serverfehler - Unerwarteter Fehler auf dem Server.
POST /weightlifting/sessions/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 123
"user_id='text'&video='text'&session_name='text'&exercise_name='text'&barbell_mass='text'&body_joint_angles=[]"{
"session_id": "text",
"title": "text"
}Pfadparameter - session_id (string, erforderlich): Die eindeutige ID der abzurufenden Sitzung.
Abfrageparameter (optional) - demo (boolean): Auf true setzen, um eine vorgefertigte Demo-Sitzung abzurufen.
Antwortstruktur (HTTP 200) Bei Erfolg enthält die Antwort ein JSON-Objekt mit: - analyzed_video_url: Öffentliche URL des analysierten Videos. - video_url: Öffentliche URL des Originalvideos. - created_at: Erstellungszeitpunkt (Datum: DD/MM/YYYY, Zeit: HH:MM AM/PM). - exercise: Die ausgeführte Übung (z.B. 'snatch'). - user_name: Der Name des zugeordneten Benutzers. - activity: Der Aktivitätstyp ('Weightlifting'). - title: Der Titel der Sitzung. - metrics: Numerische Metriken (z.B. Geschwindigkeit, Leistung). - angles: Winkelwerte (Arrays numerischer Werte). - report_metrics: Berichtsmetriken (Arrays numerischer Werte). - all_timestamps: Zeitstempel der Sitzungsdaten.
Fehlerbehandlung - 400 Ungültige Anfrage: Ungültige Parameter. - 401 Nicht autorisiert: Fehlender/ungültiger Token. - 403 Verboten: Unzureichende Berechtigungen. - 404 Nicht gefunden: Sitzung nicht gefunden oder Aktivität nicht 'Weightlifting'. - 500 Interner Serverfehler: Unerwarteter Fehler.
Sicherheit 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 eine Demo-Sitzung abzurufen.
Details der Gewichtheben-Sitzung erfolgreich abgerufen.
Öffentliche URL des analysierten Videos.
Öffentliche URL des Originalvideos.
Die ausgeführte Übung (z.B. "snatch").
Name des zugeordneten Benutzers.
Aktivitätstyp (erwartet: "Weightlifting").
Titel der Sitzung.
Zeitstempel der Sitzungsdaten.
Ungültige Anfrage - Ungültige Parameter oder Admin-UID.
Nicht autorisiert - Fehlender oder ungültiger Token.
Verboten - Unzureichende Berechtigungen.
Nicht gefunden - Sitzung nicht gefunden oder Aktivität nicht "Weightlifting".
Interner Serverfehler - Unerwarteter Fehler.
GET /weightlifting/sessions/{session_id}/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"analyzed_video_url": "https://example.com",
"video_url": "https://example.com",
"created_at": {
"date": "text",
"time": "text"
},
"exercise": "text",
"user_name": "text",
"activity": "text",
"title": "text",
"metrics": {
"ANY_ADDITIONAL_PROPERTY": 1
},
"angles": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
},
"report_metrics": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
},
"all_timestamps": [
1
]
}Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Auf true setzen, um eine vorgefertigte Demo-Zusammenfassung für diese Gewichtheber-Session zu erhalten.
Zusammenfassung der Gewichtheber-Session erfolgreich abgerufen
Art der ausgeführten Übung.
Datum der Session (z.B. '07/04/2025').
Ungültige Anfrage - Fehlerhafte Parameter.
Nicht autorisiert - Token fehlt oder abgelaufen.
Verboten - Nutzer hat keinen gültigen Zahlungsplan.
Nicht gefunden - Session nicht vorhanden.
Interner Serverfehler.
GET /weightlifting/sessions/{session_id}/summary/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"summary_text": {
"velocity": "text",
"power": "text",
"stability": "text",
"final_summary": "text"
},
"exercise_type": "text",
"velocity": {
"bar_velocity": {
"min": 1,
"max": 1,
"values": [
1
]
}
},
"power": {
"ground_reaction_force": {
"min": 1,
"max": 1,
"values": [
1
]
},
"power": {
"min": 1,
"max": 1,
"values": [
1
]
}
},
"stability": {
"total_time": 1,
"bar_height": {
"max": 1,
"values": [
1
]
},
"bar_trajectory": {
"xAxis": [
1
],
"yAxis": [
1
]
}
},
"user_information": {
"weight": 1,
"height": 1,
"age": "text",
"gender": "text",
"email": "text",
"display_name": "text"
},
"session_date": "text"
}Pfadparameter - session_id (string, erforderlich): Die eindeutige ID der Sitzung.
Abfrageparameter (optional) - demo (boolean): Auf true setzen, um eine Demo-Sitzung abzurufen.
Antwortstruktur (HTTP 200) Bei Erfolg enthält die Antwort ein JSON-Objekt mit: - keypoints: Keypoint-Daten (Arrays numerischer Werte). - angles: Winkelwerte (Arrays numerischer Werte). - all_timestamps: Zeitstempel der Sitzungsdaten. - metrics: Numerische Metriken. - activity: Aktivitätstyp ("Weightlifting").
Fehlerbehandlung - 400 Ungültige Anfrage: Ungültige Parameter. - 401 Nicht autorisiert: Fehlender/ungültiger Token. - 403 Verboten: Unzureichende Berechtigungen. - 404 Nicht gefunden: Sitzung nicht gefunden oder Aktivität nicht "Weightlifting". - 500 Interner Serverfehler: Unerwarteter Fehler.
Sicherheit 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 eine Demo-Sitzung abzurufen.
Daten der Gewichtheben-Sitzung erfolgreich abgerufen.
Zeitstempel der Sitzungsdaten.
Aktivitätstyp ("Weightlifting").
Ungültige Anfrage - Ungültige Parameter oder Admin-UID.
Nicht autorisiert - Fehlender oder ungültiger Token.
Verboten - Unzureichende Berechtigungen.
Nicht gefunden - Sitzung nicht gefunden oder Aktivität nicht "Weightlifting".
Interner Serverfehler - Unerwarteter Fehler.
GET /weightlifting/sessions/{session_id}/export/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"keypoints": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
},
"angles": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
},
"all_timestamps": [
1
],
"metrics": {
"ANY_ADDITIONAL_PROPERTY": 1
},
"activity": "text"
}Pfadparameter - session_id (string, erforderlich): Die eindeutige ID der Sitzung.
Abfrageparameter (optional) - demo (boolean): Auf true setzen, um eine Demo-Analyse abzurufen.
Antwortstruktur (HTTP 200) Die Antwort ist ein JSON-Bericht mit: - exercise: Die Übung (z.B. "snatch"). - key_metrics: Schlüsselmetriken (Leistung, Bodenreaktionskraft, Hantelgeschwindigkeit). - body_positioning: Körperpositionen (Hüftgeschwindigkeit, Schienbeinwinkel, etc.). - joint_angles: Gelenkwinkel. - barbell_positioning: Hantelpositionen. - phase_data: Phasendaten (Bilder, Durchschnittszeiten). - chart_data: Diagrammdaten (Start/Ende von Phasen). - user_information: Benutzerinformationen. - session_date: Sitzungsdatum. - comments: Kommentare.
Fehlerbehandlung - 400 Ungültige Anfrage: Ungültige Parameter. - 401 Nicht autorisiert: Fehlender/ungültiger Token. - 403 Verboten: Kein gültiger Zahlungsplan. - 404 Nicht gefunden: Sitzung nicht vorhanden. - 500 Interner Serverfehler: Unerwarteter Fehler.
Sicherheit 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 eine Demo-Analyse abzurufen.
Lift-Analysebericht erfolgreich generiert.
Ungültige Anfrage - Ungültige Sitzungsdaten.
Nicht autorisiert - Fehlender oder ungültiger Token.
Verboten - Administratorzugriff erforderlich.
Nicht gefunden - Sitzung nicht gefunden oder kein gültiger Zahlungsplan.
Interner Serverfehler - Unerwarteter Fehler.
POST /weightlifting/sessions/{session_id}/lift-analysis/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"exercise": "text",
"key_metrics": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
},
"body_positioning": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
},
"joint_angles": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
},
"barbell_positioning": {
"ANY_ADDITIONAL_PROPERTY": [
1
]
},
"phase_data": {
"ANY_ADDITIONAL_PROPERTY": {
"average_time_ms": 1
}
},
"chart_data": {
"ANY_ADDITIONAL_PROPERTY": {
"start": 1,
"end": 1
}
},
"user_information": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"session_date": "2026-01-01",
"comments": {}
}Erzeuge Kommentar-Threads zur Lift-Analyse
"power_output": "thread_a12b34",
"ground_reaction_force": "thread_c56d78",
"barbell_velocity": "thread_e90f12",
"hip_velocity": "thread_g34h56",
"shin_angle": "thread_i78j90",
"hip_height": "thread_k12l34",
"torso_angle": "thread_m56n78",
"hip_angle": "thread_o90p12",
"knee_angle": "thread_q34r56",
"bar_height": "thread_s78t90",
"barbell_trajectory": "thread_u12v34",
"vertical_shoulder_height":"thread_w56x78"
} ```
**Hinweise:**
- `session_id` muss auf eine existierende Gewichtheber-Session verweisen.
- Der Aufrufer benötigt entsprechende Berechtigungen (gültiges Token & Zahlungsplan).
- Verwenden Sie die zurückgegebenen Thread-IDs, um die generierten Kommentare später abzurufen.Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
In den Prompts verwendetes Maßsystem
Threads erfolgreich erstellt.
Wörterbuch, das Lift-Metriken Thread-IDs zuordnet.
Thread-ID für Leistungsausgabe.
Thread-ID für Bodenreaktionskraft.
Thread-ID für Hantelgeschwindigkeit.
Thread-ID für Hüftgeschwindigkeit.
Thread-ID für Schienbeinwinkel.
Thread-ID für Hüfthöhe.
Thread-ID für Rumpfwinkel.
Thread-ID für Hüftgelenkwinkel.
Thread-ID für Kniegelenkwinkel.
Thread-ID für maximale Hantelhöhe.
Thread-ID für Hantelpfad.
Thread-ID für Schulterhöhe.
Ungültige Anfrage - Fehlerhafte Parameter.
Nicht autorisiert - Token ungültig oder abgelaufen.
Verboten - Admin-Zugriff erforderlich.
Nicht gefunden - Session nicht vorhanden oder Nutzer hat keinen gültigen Zahlungsplan.
Interner Serverfehler - Unerwarteter Fehler aufgetreten.
POST /weightlifting/sessions/{session_id}/recommendation/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"power_output": "text",
"ground_reaction_force": "text",
"barbell_velocity": "text",
"hip_velocity": "text",
"shin_angle": "text",
"hip_height": "text",
"torso_angle": "text",
"hip_angle": "text",
"knee_angle": "text",
"bar_height": "text",
"barbell_trajectory": "text",
"vertical_shoulder_height": "text"
}Zusammenfassungs-Threads generieren
"velocity": "thread_thread_id",
"power": "thread_thread_id",
"stability": "thread_thread_id",
"final_summary": "thread_thread_id",
} ```
**Hinweise:**
- Stellen Sie sicher, dass die angegebene `session_id` gültig ist und einer existierenden Session im System entspricht.
- Der Nutzer muss die notwendigen Berechtigungen haben, um Zusammenfassungs-Threads zu generieren.Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Maßsystem: 'metric' oder 'imperial'
Zusammenfassungs-Threads erfolgreich generiert.
Thread-ID entsprechend einem Zusammenfassungsblock
Ungültige Anfrage - Fehlerhafte Parameter.
Nicht autorisiert - Token ungültig oder abgelaufen.
Verboten - Admin-Zugriff erforderlich.
Nicht gefunden - Session nicht vorhanden oder Nutzer hat keinen gültigen Zahlungsplan.
Interner Serverfehler - Unerwarteter Fehler aufgetreten.
POST /weightlifting/sessions/{session_id}/summary/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*
{
"velocity": "thread_id_1",
"power": "thread_id_2",
"stability": "thread_id_3",
"final_summary": "thread_id_4"
}Zuletzt aktualisiert
War das hilfreich?