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

• Point de terminaison : GET /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/ 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

• Point de terminaison : GET /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/ 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/ 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

• Point de terminaison : GET /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/ 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/ 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

• Point de terminaison : GET /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.