# Analysiertes Video ## Analysierte Video-URL abrufen > 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:\ > \`\`\`json {\ > "analyzed\_video\_url": " > } \`\`\`\ > \### 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.
````json {"openapi":"3.1.1","info":{"title":"AIKYNETIX WEB API","version":"v2"},"servers":[{"url":"https://api.aikynetix.app"}],"security":[{"Bearer":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header","description":"Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer "},"ApiKeyAuth":{"type":"apiKey","name":"API-KEY","in":"header","description":"Geben Sie Ihren API-Schlüssel im Header ein: API-KEY: "}}},"paths":{"/session-management/sessions/{session_id}/analyzed-video/":{"get":{"operationId":"session-management_sessions_analyzed-video_list","summary":"Analysierte Video-URL abrufen","description":"Ruft die analysierte Video-URL für eine bestimmte Sitzung ab oder versucht, sie zu erstellen, falls sie nicht existiert.\n### Pfadparameter\n- **session_id** *(string, erforderlich)*: Der eindeutige Bezeichner der Sitzung.\n### Abfrageparameter\nDiese optionalen Flags bestimmen, welche Art von Analyse durchgeführt werden soll, falls das Video nicht existiert:\n- **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,\n die den Browser zwingt, das Video herunterzuladen, anstatt es anzuzeigen.\n\n### Antwort (HTTP 200)\nGibt bei Erfolg ein JSON-Objekt mit einem `analyzed_video_url`-Schlüssel zurück:\n```json {\n \"analyzed_video_url\": \"https://storage.googleapis.com/.../analyzed_video.mp4\"\n} ```\n### Fehlerbehandlung\n- **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.\n### Sicherheit\nEin gültiger API-KEY-Token muss im `Authorization`-Header bereitgestellt werden.\n","parameters":[{"schema":{"type":"string"},"name":"session_id","in":"path","description":"Die Sitzungs-ID, für die das analysierte Video abgerufen oder erstellt werden soll.","required":true},{"schema":{"type":"boolean"},"name":"is_jump","in":"query","description":"Gibt an, ob diese Sitzung für Sprunganalyse ist.","required":false},{"schema":{"type":"boolean"},"name":"is_weight","in":"query","description":"Gibt an, ob diese Sitzung für Gewichtheben-Analyse ist.","required":false},{"schema":{"type":"boolean"},"name":"download","in":"query","description":"Wenn true, gibt eine signierte URL zurück, die den Download des Videos erzwingt.","required":false}],"responses":{"200":{"description":"Analysierte Video-URL erfolgreich abgerufen.","content":{"application/json":{"schema":{"type":"object","properties":{"analyzed_video_url":{"description":"URL des analysierten Videos.","type":"string","format":"uri"}}}}}},"400":{"description":"Ungültige Anfrage - Möglicherweise ungültige Parameter.","content":{"application/json":{"schema":{"description":"Fehlerschema für ungültige Anfragen (z.B. falsch formatierte UID)","type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Nicht autorisiert - Token ist ungültig oder fehlt.","content":{"application/json":{"schema":{"description":"Fehlerschema für fehlenden oder ungültigen Token","type":"object","properties":{"error":{"type":"string"}}}}}},"403":{"description":"Verboten - Benutzer hat nicht die erforderlichen Rechte oder Plan.","content":{"application/json":{"schema":{"description":"Fehlerschema für verbotenen Zugriff","type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Nicht gefunden - Sitzungsdaten oder Ressource nicht gefunden.","content":{"application/json":{"schema":{"description":"Fehlerschema für fehlende Sitzung oder Ressource","type":"object","properties":{"error":{"type":"string"}}}}}},"500":{"description":"Interner Serverfehler - Ein serverseitiger Fehler ist aufgetreten.","content":{"application/json":{"schema":{"description":"Fehlerschema für unerwartete Serverfehler","type":"object","properties":{"error":{"type":"string"}}}}}}},"tags":["session-management"]}}}} ```` ## Analysiertes Video hochladen/erstellen > 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)\ > \`\`\`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": " > } \`\`\`\ > \### 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.
````json {"openapi":"3.1.1","info":{"title":"AIKYNETIX WEB API","version":"v2"},"servers":[{"url":"https://api.aikynetix.app"}],"security":[{"Bearer":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header","description":"Geben Sie Ihren Bearer-Token (Firebase Auth) im Format ein: Bearer "},"ApiKeyAuth":{"type":"apiKey","name":"API-KEY","in":"header","description":"Geben Sie Ihren API-Schlüssel im Header ein: API-KEY: "}}},"paths":{"/session-management/sessions/{session_id}/analyzed-video/":{"post":{"operationId":"session-management_sessions_analyzed-video_create","summary":"Analysiertes Video hochladen/erstellen","description":"Lädt ein analysiertes Video für eine bestimmte Sitzung hoch oder erstellt es und gibt dessen URL zurück.\n### Pfadparameter\n- **session_id** *(string, erforderlich)*: Der eindeutige Bezeichner der Sitzung.\n### Anfragekörper (JSON)\n```json {\n \"is_jump\": true,\n \"is_weight\": false\n} ```\n- **is_jump** *(boolean, optional)*: Wenn true, behandelt dies als Sprung-Sitzung. - **is_weight** *(boolean, optional)*: Wenn true, behandelt dies als Gewichtheben-Sitzung.\n### Antwortstruktur (HTTP 200)\nBei Erfolg gibt ein JSON-Objekt mit der `analyzed_video_url` zurück:\n```json {\n \"analyzed_video_url\": \"https://storage.googleapis.com/.../analyzed_video.mp4\"\n} ```\n### Fehlerbehandlung\n- **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.\n### Sicherheit\nEin gültiger API-KEY-Token muss im `Authorization`-Header bereitgestellt werden.\n","parameters":[{"schema":{"type":"string"},"name":"session_id","in":"path","description":"Die Sitzungs-ID, für die das analysierte Video hochgeladen/erstellt werden soll.","required":true}],"responses":{"200":{"description":"Analysierte Video-URL erfolgreich generiert oder aktualisiert.","content":{"application/json":{"schema":{"type":"object","properties":{"analyzed_video_url":{"description":"URL des neu generierten oder aktualisierten analysierten Videos.","type":"string","format":"uri"}}}}}},"400":{"description":"Ungültige Anfrage - Möglicherweise ungültige Sitzungsdaten oder Video bereits analysiert.\n","content":{"application/json":{"schema":{"description":"Fehlerschema für ungültige Anfragen oder bereits analysiertes Video","type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Nicht autorisiert - Der Token fehlt oder ist ungültig.","content":{"application/json":{"schema":{"description":"Fehlerschema für fehlenden oder ungültigen Token","type":"object","properties":{"error":{"type":"string"}}}}}},"403":{"description":"Verboten - Der Benutzer hat keinen gültigen Zahlungsplan.","content":{"application/json":{"schema":{"description":"Fehlerschema für unzureichende Planberechtigungen","type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Nicht gefunden - Sitzung nicht gefunden oder Erstellung fehlgeschlagen.","content":{"application/json":{"schema":{"description":"Fehlerschema für fehlende Sitzungsdaten oder Ressource","type":"object","properties":{"error":{"type":"string"}}}}}},"500":{"description":"Interner Serverfehler - Ein serverseitiger Fehler ist aufgetreten.","content":{"application/json":{"schema":{"description":"Fehlerschema für unerwartete Serverfehler","type":"object","properties":{"error":{"type":"string"}}}}}}},"tags":["session-management"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"is_jump":{"description":"Ob diese Sitzung sprungbezogen ist.","type":"boolean"},"is_weight":{"description":"Ob diese Sitzung gewichthebenbezogen ist.","type":"boolean"}}}}},"required":true}}}}} ```` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.aikynetix.app/de/api-documentation/developer-resources-and-api-reference/api-reference/analyzed-video.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.