# Points de Terminaison API de Récupération

Notre système expose plusieurs points de terminaison qui renvoient les détails de la session – y compris l’URL de la vidéo traitée (analysée). Utilisez le point de terminaison correspondant à l’activité de votre session :

## **A. Points de terminaison spécifiques aux sessions**

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

* **Point de terminaison :** [`GET /jumping/sessions/{session_id}/`](/fr/api-documentation/developer-resources-and-api-reference/api-reference/jumping.md#jumping-sessions-session_id)
* **Description :** Récupère les données détaillées d’une session de saut. La réponse inclut une `analyzed_video_url` (une URI publique pointant vers la vidéo analysée) ainsi que la `video_url` originale et d’autres métriques de la session.
* **Exemple de fragment de réponse :**

```
{
  "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/**](/fr/api-documentation/developer-resources-and-api-reference/api-reference/jumping.md#jumping-sessions-session_id-export)\
Exporte des données complètes pour une session de saut. Ce point de terminaison fournit des points clés de repère, des données d’angle et d’autres métriques utiles pour une analyse approfondie.

***

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

* **Point de terminaison :** [`GET /running/sessions/{session_id}/`](/fr/api-documentation/developer-resources-and-api-reference/api-reference/running.md#running-sessions-session_id)
* **Description :** Retourne les détails d’une session de course. La réponse inclut une `analyzed_video_url` ainsi que des métriques, des angles, des horodatages et d’autres données pertinentes.
* **Exemple de fragment de réponse :**

```
{
  "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/**](/fr/api-documentation/developer-resources-and-api-reference/api-reference/running.md#running-sessions-session_id-export)\
  Exporte les données d’une session de course pour une analyse plus poussée. Cela inclut des points clés, des angles, des horodatages et des métriques de performance supplémentaires.
* [**GET /sessions/{session\_id}/analyzed-video/**](/fr/api-documentation/developer-resources-and-api-reference/api-reference/analyzed-video.md#session-management-sessions-session_id-analyzed-video)\
  Récupère l’URL de la vidéo analysée. Si la vidéo n’est pas encore disponible, ce point de terminaison peut déclencher sa génération.

***

### [**Sessions d’haltérophilie**](/fr/api-documentation/developer-resources-and-api-reference/api-reference/weightlifting.md)

* **Point de terminaison :** [`GET /weightlifting/sessions/{session_id}/`](/fr/api-documentation/developer-resources-and-api-reference/api-reference/weightlifting.md#weightlifting-sessions-session_id)
* **Description :** Récupère les détails d’une session d’haltérophilie. En plus des métriques et angles spécifiques à l’exercice, la réponse renvoie une `analyzed_video_url` montrant le levage traité.
* **Exemple de fragment de réponse :**

```
{
  "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/**](/fr/api-documentation/developer-resources-and-api-reference/api-reference/weightlifting.md#weightlifting-sessions-session_id-export)\
  Exporte les données d’une session d’haltérophilie, qui incluent des points clés, des angles, des horodatages et des métriques numériques.
* [**GET /weightlifting/sessions/{session\_id}/lift-analysis/**](/fr/api-documentation/developer-resources-and-api-reference/api-reference/weightlifting.md#weightlifting-sessions-session_id-lift-analysis)\
  Obtient des images d’analyse détaillées et des recommandations pour le levage. Ce point de terminaison renvoie des résultats d’analyse multilingues pour un examen approfondi.

***

### [**Gestion des sessions – Vidéo analysée**](/fr/api-documentation/developer-resources-and-api-reference/api-reference/managing-all-sessions.md)

* **Point de terminaison :** [`GET /session-management/sessions/{session_id}/analyzed-video/`](/fr/api-documentation/developer-resources-and-api-reference/api-reference/analyzed-video.md#session-management-sessions-session_id-analyzed-video)
* **Description :** Ce point de terminaison récupère l’URL de la vidéo analysée pour une session (si le traitement est terminé) ou déclenche une routine de recherche/création si elle n’est pas encore disponible.
* **Exemple de requête :**

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

## **B. Sécurité et utilisation**

* **Authentification :**\
  Chaque appel de récupération nécessite un jeton API-KEY valide dans l’en-tête `Authorization`.
* **Contrôle d’accès :**\
  Seuls les utilisateurs authentifiés (avec les privilèges appropriés) peuvent récupérer les détails de la session. Les requêtes non autorisées renvoient des réponses HTTP 401 avec un message d’erreur clair.


---

# 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/fr/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.