Verwaltung aller Sitzungen
Allgemeine Sitzungsverwaltung
Antwortstruktur
"sessions": {
"<session_id>": {
"created_at": {
"date": "DD/MM/YYYY",
"time": "HH:MM AM/PM"
},
"video_url": "...",
"segments": <number>,
"analyzed_video_url": "...",
"activity": "...",
"title": "...",
"user_id": "...",
"user_name": "...",
"report_comments": {...},
"metrics": {...}
// weitere Sitzungsfelder
},
"...": {...}
}
} ```
### Fehlerbehandlung
- **400 Bad Request**: Ungültige Parameter (z.B. fehlendes oder falsch formatiertes Token). - **401 Unauthorized**: Das Token fehlt oder ist ungültig. - **403 Forbidden**: Der Benutzer hat keine Administratorrechte. - **404 Not Found**: Sitzungen konnten nicht abgerufen werden (z.B. keine Sitzungen gefunden). - **500 Internal Server Error**: Ein unerwarteter Fehler ist aufgetreten.
### Sicherheit Ein gültiger API-KEY-Token muss im `Authorization`-Header bereitgestellt werden.Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Benutzersitzungen erfolgreich abgerufen.
Bad Request - Ungültige Parameter oder fehlendes Token.
Unauthorized - Das Token fehlt oder ist ungültig.
Forbidden - Der Benutzer hat nicht die erforderlichen Berechtigungen.
Not Found - Sitzungen konnten nicht abgerufen werden (z.B. keine gefunden).
Internal Server Error - Ein unerwarteter Fehler ist aufgetreten.
Anfragebody - session_ids (erforderlich): Eine Liste von Sitzungsdokument-IDs, die abgerufen werden sollen.
Sicherheit Erfordert Bearer-Token im Authorization-Header.
Authorization-Header.Fehler - 400 Bad Request: Ungültige Eingabe. - 401 Unauthorized: Fehlendes oder ungültiges Token. - 403 Forbidden: Der Benutzer ist nicht autorisiert. - 500 Internal Server Error: Ein unerwarteter Fehler ist aufgetreten.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Liste von Sitzungsdokument-IDs, die abgerufen werden sollen.
Sitzungen erfolgreich abgerufen.
Bad Request - session_ids fehlen oder sind ungültig.
Unauthorized - Kein Token bereitgestellt.
Forbidden - Benutzer ist kein Administrator.
Internal Server Error - Ein Fehler ist auf dem Server aufgetreten.
Abfrageparameter - start_after_id (string, optional): Sitzungs-ID, nach der die Paginierung beginnen soll. Wird nur verwendet, wenn keine Filter gesetzt sind. - end_before_id (string, optional): Sitzungs-ID, vor der die Paginierung enden soll. Wird nur verwendet, wenn keine Filter gesetzt sind. - limit (integer, optional): Maximale Anzahl der abzurufenden Sitzungen (Standard=10). - activity (string, optional): Filter nach Aktivitätstyp (z.B. 'Running', 'Vertical Jump'). - start_date (string, optional, Format: dd/mm/yyyy): Filtert Sitzungen, die an oder nach diesem Datum erstellt wurden. - end_date (string, optional, Format: dd/mm/yyyy): Filtert Sitzungen, die an oder vor diesem Datum erstellt wurden. - title (string, optional): Filtert Sitzungen, deren Titel diese Teilzeichenkette enthält (Groß-/Kleinschreibung wird ignoriert). - user_id (string, optional): Filtert nach Benutzer-ID, die in der Sitzung gespeichert ist. | uploaded_by | string | NEU UID des Benutzers, der das Rohvideo hochgeladen hat. | | video_status | string processed\|failed | NEU aktueller Status. |
processed\|failed | NEU aktueller Status. |Antwortstruktur (HTTP 200) Bei Erfolg enthält die Antwort ein JSON-Objekt mit: - query_count (integer): Die Gesamtzahl der passenden Sitzungen. - sessions (object): Ein Wörterbuch von Sitzungsdokumenten, geordnet nach ihren Sitzungs-IDs. - first_doc_id (string oder null): Die ID des ersten Dokuments im zurückgegebenen Satz. - last_doc_id (string oder null): Die ID des letzten Dokuments im zurückgegebenen Satz.
Fehlerbehandlung - 400 Bad Request: Ungültige Parameter (z.B. falsch formatierte Datumszeichenkette) oder fehlendes Benutzertoken. - 401 Unauthorized: Das Token fehlt oder ist ungültig. - 403 Forbidden: Der Benutzer hat keine Administratorrechte. - 404 Not Found: Keine passenden Sitzungen gefunden. - 500 Internal Server Error: Ein unerwarteter Fehler ist aufgetreten.
Sicherheit Ein gültiger API-KEY-Token muss im Authorization-Header bereitgestellt werden.
Authorization-Header bereitgestellt werden.Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Sitzungs-ID, nach der die Paginierung beginnen soll (wird nur verwendet, wenn keine Filter gesetzt sind).
Sitzungs-ID, vor der die Paginierung enden soll (wird nur verwendet, wenn keine Filter gesetzt sind).
Maximale Anzahl der abzurufenden Sitzungen (Standard=10).
Aktivitätstyp-Filter (z.B. 'Running', 'Weightlifting', 'Vertical Jump' oder 'Mobility Assessment').
Filtert Sitzungen, die an oder nach diesem Datum erstellt wurden (dd/mm/yyyy).
Filtert Sitzungen, die an oder vor diesem Datum erstellt wurden (dd/mm/yyyy).
Filtert Sitzungen, deren Titel diese Teilzeichenkette enthält (Groß-/Kleinschreibung wird ignoriert).
Filtert nach Benutzer-ID, die in der Sitzung gespeichert ist.
ID des Benutzers (Admin / Sub-Admin), der das Video hochgeladen hat.
Verarbeitungsstatus des Sitzungsvideos.
Gefilterte Sitzungen erfolgreich abgerufen.
Gesamtzahl der passenden Sitzungen.
ID der ersten Sitzung im Ergebnis oder null, falls keine vorhanden.
ID der letzten Sitzung im Ergebnis oder null, falls keine vorhanden.
Bad Request - Möglicherweise ungültige Parameter (falsch formatiertes Datum usw.) oder fehlendes Benutzertoken.
Unauthorized - Fehlendes oder ungültiges Zugriffstoken.
Forbidden - Der Benutzer hat keine Administratorrechte.
Not Found - Keine passenden Sitzungen gefunden oder Ressource nicht verfügbar.
Internal Server Error - Ein unerwarteter Fehler ist aufgetreten.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Neuer Titel für die Sitzung.
Aktualisierter Zeitstempel der Sitzung im Format YYYY-MM-DD HH:MM:SS.
Sitzung erfolgreich aktualisiert.
Bestätigungsnachricht.
Ungültige Anfrage - Ungültige Parameter oder fehlende Daten.
Nicht autorisiert - Fehlender oder ungültiger Zugriffstoken.
Verboten - Der Benutzer hat nicht die erforderlichen Berechtigungen, um Gesamtmetriken abzurufen.
Nicht gefunden - Die angegebene Sitzungs-ID existiert nicht.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Sitzung erfolgreich gelöscht.
Bestätigungsnachricht.
Ungültige Anfrage - Ungültige Parameter oder fehlende Daten.
Nicht autorisiert - Token ist ungültig oder abgelaufen.
Verboten - Benutzer hat nicht die erforderlichen Berechtigungen.
Nicht gefunden - Die angegebene Sitzungs-ID existiert nicht.
Interner Serverfehler - Ein unerwarteter Fehler ist aufgetreten.
Pfadparameter
Abfrageparameter
Antwort (HTTP 200)
"analyzed_video_url": "https://storage.googleapis.com/.../analyzed_video.mp4"
} ```
### Fehlerbehandlung
- **400 Bad Request**: Ungültige Parameter (z.B. fehlende oder ungültige Admin-UID). - **401 Unauthorized**: Token fehlt oder ist ungültig. - **403 Forbidden**: Der Benutzer hat nicht die erforderlichen Rechte oder Plan. - **404 Not Found**: Die Sitzungsdaten oder Ressourcen konnten nicht gefunden werden. - **500 Internal Server Error**: Ein unerwarteter Fehler ist auf dem Server aufgetreten.
### Sicherheit
Ein gültiger API-KEY-Token muss im `Authorization`-Header bereitgestellt werden.Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Gibt an, ob diese Sitzung für Sprunganalyse ist.
Gibt an, ob diese Sitzung für Gewichtheben-Analyse ist.
Wenn true, gibt eine signierte URL zurück, die den Download des Videos erzwingt.
Analysierte Video-URL erfolgreich abgerufen.
URL des analysierten Videos.
Ungültige Anfrage - Möglicherweise ungültige Parameter.
Nicht autorisiert - Token ist ungültig oder fehlt.
Verboten - Benutzer hat nicht die erforderlichen Rechte oder Plan.
Nicht gefunden - Sitzungsdaten oder Ressource nicht gefunden.
Interner Serverfehler - Ein serverseitiger Fehler ist aufgetreten.
Pfadparameter
Anfragekörper (JSON)
"is_jump": true,
"is_weight": false
} ```
- **is_jump** *(boolean, optional)*: Wenn true, behandelt dies als Sprung-Sitzung. - **is_weight** *(boolean, optional)*: Wenn true, behandelt dies als Gewichtheben-Sitzung.
### Antwortstruktur (HTTP 200)
Bei Erfolg gibt ein JSON-Objekt mit der `analyzed_video_url` zurück:
```json {
"analyzed_video_url": "https://storage.googleapis.com/.../analyzed_video.mp4"
} ```
### Fehlerbehandlung
- **400 Bad Request**: Ungültige Parameter oder Sitzung bereits analysiert. - **401 Unauthorized**: Token fehlt oder ist ungültig. - **403 Forbidden**: Der Benutzer hat keinen gültigen Plan. - **404 Not Found**: Sitzungsdaten nicht gefunden. - **500 Internal Server Error**: Ein unerwarteter Fehler ist auf dem Server aufgetreten.
### Sicherheit
Ein gültiger API-KEY-Token muss im `Authorization`-Header bereitgestellt werden.Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer
Ob diese Sitzung sprungbezogen ist.
Ob diese Sitzung gewichthebenbezogen ist.
Analysierte Video-URL erfolgreich generiert oder aktualisiert.
URL des neu generierten oder aktualisierten analysierten Videos.
Ungültige Anfrage - Möglicherweise ungültige Sitzungsdaten oder Video bereits analysiert.
Nicht autorisiert - Der Token fehlt oder ist ungültig.
Verboten - Der Benutzer hat keinen gültigen Zahlungsplan.
Nicht gefunden - Sitzung nicht gefunden oder Erstellung fehlgeschlagen.
Interner Serverfehler - Ein serverseitiger Fehler ist aufgetreten.
Zuletzt aktualisiert
War das hilfreich?