# API-Endpunkte zum Abrufen

Unser System stellt mehrere Endpunkte bereit, die Sitzungsdetails zurückgeben – einschließlich der URL zum verarbeiteten (analysierten) Video. Verwenden Sie den Endpunkt, der zur Aktivität Ihrer Sitzung passt:

**A. Sitzungsspezifische Endpunkte**

### [**Sprungsitzungen**](/de/api-documentation/developer-resources-and-api-reference/api-reference/jumping.md)

* **Endpunkt:** [`GET /jumping/sessions/{session_id}/`](/de/api-documentation/developer-resources-and-api-reference/api-reference/jumping.md#jumping-sessions-session_id)
* **Beschreibung:** Ruft detaillierte Daten für eine Sprungsitzung ab. Die Antwort enthält eine `analyzed_video_url` (eine öffentliche URI, die auf das analysierte Video verweist) zusammen mit der ursprünglichen `video_url` und weiteren Sitzungsmetriken.
* **Beispielantwort-Fragment:**

```
{
  "session_id": "abcd1234",
  "analyzed_video_url": "https://storage.googleapis.com/your-bucket/analyzed_video.mp4",
  "video_url": "https://storage.googleapis.com/your-bucket/original_video.mov",
  "created_at": { "date": "05/02/2025", "time": "06:00 PM" },
  ...
}
```

[**GET /jumping/sessions/{session\_id}/export/**](/de/api-documentation/developer-resources-and-api-reference/api-reference/jumping.md#jumping-sessions-session_id-export)\
Exportiert umfassende Daten für eine Sprungsitzung. Dieser Endpunkt liefert markante Schlüsselstellen, Winkelinformationen und weitere Metriken, die für eine tiefgehende Analyse nützlich sind.

***

### [**Laufsitzungen**](/de/api-documentation/developer-resources-and-api-reference/api-reference/running.md)

* **Endpunkt:** [`GET /running/sessions/{session_id}/`](/de/api-documentation/developer-resources-and-api-reference/api-reference/running.md#running-sessions-session_id)
* **Beschreibung:** Gibt Details für eine Laufsitzung zurück. Die Antwort enthält eine `analyzed_video_url` zusammen mit Metriken, Winkeln, Zeitstempeln und weiteren relevanten Daten.
* **Beispielantwort-Fragment:**

```
{
  "session_id": "abcd1234",
  "analyzed_video_url": "https://storage.googleapis.com/your-bucket/analyzed_video.mp4",
  "video_url": "https://storage.googleapis.com/your-bucket/original_video.mov",
  "created_at": { "date": "05/02/2025", "time": "06:00 PM" },
  ...
}
```

* [**GET /running/sessions/{session\_id}/export/**](/de/api-documentation/developer-resources-and-api-reference/api-reference/running.md#running-sessions-session_id-export)\
  Exportiert Laufsitzungsdaten für eine weitere Analyse. Dies umfasst Schlüsselstellen, Winkel, Zeitstempel und zusätzliche Leistungsmetriken.
* [**GET /sessions/{session\_id}/analyzed-video/**](/de/api-documentation/developer-resources-and-api-reference/api-reference/analyzed-video.md#session-management-sessions-session_id-analyzed-video)\
  Ruft die URL für das analysierte Video ab. Falls das Video noch nicht verfügbar ist, kann dieser Endpunkt dessen Generierung auslösen.

***

### [**Gewichthebungssitzungen**](/de/api-documentation/developer-resources-and-api-reference/api-reference/weightlifting.md)

* **Endpunkt:** [`GET /weightlifting/sessions/{session_id}/`](/de/api-documentation/developer-resources-and-api-reference/api-reference/weightlifting.md#weightlifting-sessions-session_id)
* **Beschreibung:** Ruft Details für eine Gewichthebungssitzung ab. Neben übungsspezifischen Metriken und Winkeln gibt die Antwort eine `analyzed_video_url` zurück, die das verarbeitete Heben zeigt.
* **Beispielantwort-Fragment:**

```
{
  "session_id": "abcd1234",
  "analyzed_video_url": "https://storage.googleapis.com/your-bucket/analyzed_video.mp4",
  "video_url": "https://storage.googleapis.com/your-bucket/original_video.mov",
  "created_at": { "date": "05/02/2025", "time": "06:00 PM" },
  ...
}
```

* [**GET /weightlifting/sessions/{session\_id}/export/**](/de/api-documentation/developer-resources-and-api-reference/api-reference/weightlifting.md#weightlifting-sessions-session_id-export)

  Exportiert Gewichthebungssitzungsdaten, die Schlüsselstellen, Winkel, Zeitstempel und numerische Metriken umfassen.
* [**GET /weightlifting/sessions/{session\_id}/lift-analysis/**](/de/api-documentation/developer-resources-and-api-reference/api-reference/weightlifting.md#weightlifting-sessions-session_id-lift-analysis)\
  Ruft detaillierte Analysebilder und Empfehlungen für das Heben ab. Dieser Endpunkt liefert mehrsprachige Analysergebnisse für eine weitere Überprüfung.

***

### [**Sitzungsverwaltung – Analysiertes Video**](/de/api-documentation/developer-resources-and-api-reference/api-reference/analyzed-video.md)

* **Endpunkt:** [`GET /session-management/sessions/{session_id}/analyzed-video/`](/de/api-documentation/developer-resources-and-api-reference/api-reference/analyzed-video.md#session-management-sessions-session_id-analyzed-video)
* **Beschreibung:** Dieser Endpunkt ruft entweder die URL des analysierten Videos für eine Sitzung ab (wenn die Verarbeitung abgeschlossen ist) oder löst eine Such-/Erstellungsroutine aus, falls sie noch nicht verfügbar ist.
* **Beispielanfrage:**

```
GET /session-management/sessions/abcd1234/analyzed-video/ HTTP/1.1
Host: api.example.com
API-KEY: <token>
```

### **B. Sicherheit und Nutzung**

* **Authentifizierung:**\
  Jeder Abrufaufruf erfordert einen gültigen Token im API-KEY-Header.
* **Zugriffskontrolle:**\
  Nur authentifizierte Benutzer (mit entsprechenden Berechtigungen) dürfen Sitzungsdetails abrufen. Unbefugte Anfragen führen zu HTTP-401-Antworten mit einer klaren Fehlermeldung.


---

# 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/retrieving-processed-videos/retrieval-api-endpoints.md?ask=<question>
```

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.