Analysiertes Video

GET- und POST-Anfragen zur Abrufung des Links zum analysierten Video

Analysierte Video-URL abrufen

get

Ruft die analysierte Video-URL für eine bestimmte Sitzung ab oder versucht, sie zu erstellen, falls sie nicht existiert.

Pfadparameter

• session_id (string, erforderlich): Der eindeutige Bezeichner der Sitzung.

Abfrageparameter

Diese optionalen Flags bestimmen, welche Art von Analyse durchgeführt werden soll, falls das Video nicht existiert:

• is_jump (boolean, optional): Gibt an, ob diese Sitzung für Sprunganalyse ist. - is_weight (boolean, optional): Gibt an, ob diese Sitzung für Gewichtheben-Analyse ist. - download (boolean, optional): Wenn true, gibt eine signierte URL zurück, die den Browser zwingt, das Video herunterzuladen, anstatt es anzuzeigen.

Antwort (HTTP 200)

Gibt bei Erfolg ein JSON-Objekt mit einem analyzed_video_url-Schlüssel zurück:

  "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.

Autorisierungen

BearerApiKeyAuth

AuthorizationstringErforderlich

Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer

Pfadparameter

session_idanyErforderlich

Abfrageparameter

is_jumpbooleanOptional

Gibt an, ob diese Sitzung für Sprunganalyse ist.

is_weightbooleanOptional

Gibt an, ob diese Sitzung für Gewichtheben-Analyse ist.

downloadbooleanOptional

Wenn true, gibt eine signierte URL zurück, die den Download des Videos erzwingt.

Antworten

200

Analysierte Video-URL erfolgreich abgerufen.

application/json

analyzed_video_urlstring · uriOptional

URL des analysierten Videos.

400

Ungültige Anfrage - Möglicherweise ungültige Parameter.

application/json

401

Nicht autorisiert - Token ist ungültig oder fehlt.

application/json

403

Verboten - Benutzer hat nicht die erforderlichen Rechte oder Plan.

application/json

404

Nicht gefunden - Sitzungsdaten oder Ressource nicht gefunden.

application/json

500

Interner Serverfehler - Ein serverseitiger Fehler ist aufgetreten.

application/json

get

/session-management/sessions/{session_id}/analyzed-video/

HTTPcURLJavaScriptPython

GET /session-management/sessions/{session_id}/analyzed-video/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*

{
  "analyzed_video_url": "https://example.com"
}

Analysiertes Video hochladen/erstellen

post

Lädt ein analysiertes Video für eine bestimmte Sitzung hoch oder erstellt es und gibt dessen URL zurück.

Pfadparameter

• session_id (string, erforderlich): Der eindeutige Bezeichner der Sitzung.

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.

Autorisierungen

BearerApiKeyAuth

AuthorizationstringErforderlich

Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer

Pfadparameter

session_idanyErforderlich

Body

application/json

is_jumpbooleanOptional

Ob diese Sitzung sprungbezogen ist.

is_weightbooleanOptional

Ob diese Sitzung gewichthebenbezogen ist.

Antworten

200

Analysierte Video-URL erfolgreich generiert oder aktualisiert.

application/json

analyzed_video_urlstring · uriOptional

URL des neu generierten oder aktualisierten analysierten Videos.

400

Ungültige Anfrage - Möglicherweise ungültige Sitzungsdaten oder Video bereits analysiert.

application/json

401

Nicht autorisiert - Der Token fehlt oder ist ungültig.

application/json

403

Verboten - Der Benutzer hat keinen gültigen Zahlungsplan.

application/json

404

Nicht gefunden - Sitzung nicht gefunden oder Erstellung fehlgeschlagen.

application/json

500

Interner Serverfehler - Ein serverseitiger Fehler ist aufgetreten.

application/json

post

/session-management/sessions/{session_id}/analyzed-video/

HTTPcURLJavaScriptPython

POST /session-management/sessions/{session_id}/analyzed-video/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "is_jump": true,
  "is_weight": false
}

{
  "analyzed_video_url": "https://example.com"
}