Ctrlk
WebsitePlatform

Évaluation de la mobilité

Générer un rapport de mobilité articulaire

post

Génère un rapport résumé de mobilité articulaire pour un session_id donné.

Paramètre de Chemin

  • session_id (string, requis) : L'identifiant unique de la session de mobilité.

Réponse de Succès (HTTP 200)

Renvoie un objet JSON contenant :

  • title (string) : Le titre de la session. - angles (object) : Les clés sont des noms d'articulations, les valeurs sont :

    • max (number|null)

    • min (number|null)

    • values (array[number])

  • exercise (string) : Toujours Joint Angle Mobility. - user_info (object) : Détails de l'utilisateur. - date (string) : Date formatée (JJ/MM/AAAA). - uploaded_date (string, date-time) : Horodatage ISO brut. - shown_angles (array[string]) : Quels angles afficher. - comments (object[string → string]) : Commentaires par angle.

Réponses d'Erreur

  • 400 Requête incorrecte : Type de session ou paramètres invalides. - 404 Non trouvé : Session non trouvée. - 500 Erreur interne du serveur : Erreur serveur inattendue. Requiert un token API-KEY valide dans l'en-tête Authorization.

Autorisations
AuthorizationstringRequis

Entrez votre token Bearer (authentification Firebase) au format : Bearer

Paramètres de chemin
session_idanyRequis
Réponses
200

Rapport de mobilité articulaire récupéré avec succès.

application/json
titlestringRequis

Titre de la session

exercisestringRequis

Nom de l'exercice, 'Joint Angle Mobility'

datestringRequis

Date de la session au format JJ/MM/AAAA

uploaded_datestring · date-timeRequis

Horodatage ISO brut du téléchargement

shown_anglesstring[]Optionnel

Angles que l'utilisateur a choisi d'afficher

post
/mobility-assessment/sessions/{session_id}/joint-mobility/

Récupérer une session d'évaluation de mobilité

get

Récupère les détails d'une session spécifique d'Évaluation de Mobilité identifiée par son session_id. Ce point de terminaison renvoie des informations telles que le nombre de segments, les URLs vidéo, les données d'angle, les horodatages et autres métadonnées de session.

Paramètre de Chemin

  • session_id (string, requis) : Identifiant unique de la session d'Évaluation de Mobilité à récupérer.

Paramètre de Requête

  • demo (booléen, optionnel) : Définir à true pour récupérer la session de démonstration pré-générée au lieu d'une réelle.

Réponse de Succès (HTTP 200)

Un objet JSON contenant :

  • segments (entier) : Le nombre total de segments dans cette évaluation. - video_url (string, URI) : URL de la vidéo originale téléchargée. - analyzed_video_url (string, URI, optionnel) : URL de la vidéo analysée (traitée). - activity (string) : Le type d'activité, ex. Évaluation de Mobilité. - title (string) : Titre ou nom de la session. - user_name (string) : Nom de l'utilisateur associé à la session. - created_at (object) : Un objet avec date et time pour la création de la session.

    • date (string) : Format JJ/MM/AAAA.

    • time (string) : Format HH:MM AM/PM.

  • exercise (string) : Le nom ou type d'exercice (ex. Overhead Squad). - angles (object) : Un objet contenant les données d'angle pertinentes pour l'évaluation.

    • hip_angle (array de nombres) : Exemple de tableau d'angles de hanche.

    • ankle_angle (array de nombres) : Exemple de tableau d'angles de cheville.

    • ... (champs d'angle supplémentaires si nécessaire)

  • all_timestamps (array de nombres) : Tableau d'horodatages correspondant aux données d'angle.

Réponses d'Erreur

  • 400 Requête incorrecte : Paramètres invalides ou manquants. - 401 Non autorisé : Token d'authentification manquant ou invalide. - 403 Interdit : L'utilisateur n'a pas la permission de récupérer cette session. - 404 Non trouvé : Session non trouvée. - 500 Erreur interne du serveur : Une erreur inattendue s'est produite sur le serveur. Un token API-KEY valide doit être fourni dans l'en-tête Authorization.

Autorisations
AuthorizationstringRequis

Entrez votre token Bearer (authentification Firebase) au format : Bearer

Paramètres de chemin
session_idanyRequis
Paramètres de requête
demobooleanOptionnel

Définir à true pour récupérer la session de démonstration pré-générée au lieu d'une réelle.

Réponses
200

Données de session d'Évaluation de Mobilité récupérées avec succès.

application/json
segmentsintegerRequis

Nombre de segments dans cette évaluation de mobilité.

video_urlstring · uriRequis

URL de la vidéo originale.

analyzed_video_urlstring · uriOptionnel

URL optionnelle de la vidéo traitée.

activitystringRequis

Type d'activité, ex. 'Évaluation de Mobilité'.

titlestringRequis

Un titre de session convivial.

user_namestringRequis

Nom de l'utilisateur associé à cette session.

exercisestringRequis

Le nom de l'exercice, ex. 'Overhead Squad'.

all_timestampsnumber[]Requis

Tableau d'horodatages numériques correspondant à chaque entrée de données d'angle.

get
/mobility-assessment/sessions/{session_id}/

Exporter les données de session (Évaluation de Mobilité)

get

Exporte les données de points de repère et d'angle pour une session spécifique liée à la mobilité. Ce point de terminaison renvoie des métadonnées minimales, incluant uniquement activity, angles, all_timestamps, et keypoints avec divers tableaux de points de repère.

Paramètre de Chemin

  • session_id (string, requis) : L'identifiant unique de la session dont les données sont exportées.

Paramètre de Requête

  • demo (booléen, optionnel) : Définir à true pour récupérer les données de session de démonstration au lieu d'une réelle.

Réponse de Succès (HTTP 200)

Un objet JSON contenant :

  • activity (string) : Le type d'activité (ex. 'Évaluation de Mobilité'). - angles (object) : Un objet contenant les données d'angle pertinentes pour l'évaluation.

    • hip_angle (array de nombres) : Exemple de tableau d'angles de hanche.

    • ankle_angle (array de nombres) : Exemple de tableau d'angles de cheville.

    • ... (champs d'angle supplémentaires si nécessaire)

  • all_timestamps (array de nombres) : Tableau d'horodatages correspondant à chaque point de données. - keypoints (object) : Contient des tableaux de points de repère. Exemples :

    • lknev (array de nombres) : Tableau de points de repère du genou gauche.

    • ltoev (array de nombres) : Tableau de points de repère de l'orteil gauche.

    • relbv (array de nombres) : Tableau de points de repère du coude droit.

    • rtoey (array de nombres) : Tableau de points de repère de l'orteil droit.

    • headv (array de nombres) : Tableau de points de repère de la tête.

    • rearv (array de nombres) : Tableau de points de repère de l'oreille droite.

    • rshox (array de nombres) : Tableau de points de repère de l'épaule droite.

    • etc (array de nombres) : Tableau de tous les autres points de repère.

Réponses d'Erreur

  • 400 Requête incorrecte : Paramètres invalides ou manquants. - 401 Non autorisé : Token d'authentification manquant ou invalide. - 403 Interdit : Privilèges insuffisants pour récupérer ces données. - 404 Non trouvé : La session n'existe pas. - 500 Erreur interne du serveur : Une erreur inattendue s'est produite. Un token API-KEY valide doit être fourni dans l'en-tête Authorization.

Autorisations
AuthorizationstringRequis

Entrez votre token Bearer (authentification Firebase) au format : Bearer

Paramètres de chemin
session_idanyRequis
Paramètres de requête
demobooleanOptionnel

Définir à true pour récupérer les données de session de démonstration au lieu d'une réelle.

Réponses
200

Données de session exportées avec succès.

application/json
activitystringRequis

Type d'activité (ex., 'Évaluation de Mobilité').

all_timestampsnumber[]Requis

Tableau d'horodatages numériques correspondant à chaque point de données.

get
/mobility-assessment/sessions/{session_id}/export/

Créer une nouvelle session de traitement vidéo

post

Ce point de terminaison permet à un administrateur (ou sous-admin) de télécharger un fichier vidéo pour traitement et de créer une nouvelle ressource "session" au nom d'un autre utilisateur (Évaluation de Mobilité). Le serveur renverra un session_id qui peut être utilisé pour interroger ou récupérer les détails/résultats de la session.

Corps de la Requête (Multipart/Form-Data)

Vous devez fournir les champs suivants :

  • user_id (string, requis) : L'ID de l'utilisateur pour lequel cette session est créée. - video (fichier, requis) : Le fichier vidéo brut à traiter. - session_name (string, optionnel) : Un nom/lisible pour la session. - exercise_name (string, requis) : Le nom de l'exercice à effectuer. Choisissez parmi : - body_joint_angles (array[string], optionnel) : Une liste de noms d'articulations séparés par des virgules (ex. 'coude, genou, cheville'). Par défaut ['all'] si non fourni.

Structure de la Réponse

En cas de succès (HTTP 200), la réponse est un objet JSON avec : - session_id (string) : Un identifiant unique pour la session créée. - title (string) : Le titre de la session (par défaut une valeur générique si session_name n'est pas fourni).

Workflow

  1. POST une requête multipart/form-data contenant les champs requis user_id et video, plus les champs optionnels. 2. Fournir un token API-KEY valide dans l'en-tête Authorization. 3. L'appelant doit avoir des privilèges admin pour créer une session pour un autre utilisateur. 4. Si réussi, le serveur répond avec session_id et title. 5. En cas d'erreur (ex. champs manquants, permissions insuffisantes), un objet JSON avec une clé error est retourné.

Exemple cURL :

     -H 'Content-Type: multipart/form-data' \
     -H 'Authorization: API-KEY <VOTRE_TOKEN_ADMIN>' \
     -F 'user_id=someUserId123' \
     -F 'video=@/chemin/vers/video.mp4' \
     -F 'session_name=Session Personnalisée' \
     -F 'body_joint_angles=cheville, genou' \
     https://<backend-link>/mobility-assessment/management/sessions/
Autorisations
AuthorizationstringRequis

Entrez votre token Bearer (authentification Firebase) au format : Bearer

Corps
user_idstringRequis

Requis. L'ID de l'utilisateur pour lequel cette session est créée (champ de formulaire : texte).

videostringRequis

Requis. Le fichier vidéo brut à traiter (type de champ de formulaire : fichier).

session_namestringOptionnel

Optionnel. Un nom descriptif pour la session (champ de formulaire : texte).

exercisestringRequis

Requis. Le nom de l'exercice. Choisissez parmi : 'Overhead Squat', 'Joint Angle Mobility'

body_joint_anglesarrayOptionnel

Optionnel. Une liste de noms d'articulations séparés par des virgules. Valeurs disponibles : 'cheville', 'genou', 'coude', 'hanche', 'épaule'. Exemple : cheville,genou,hanche

Réponses
200

Session de traitement vidéo créée avec succès (HTTP 200).

application/json
session_idstringRequis

L'identifiant unique de la session créée.

titlestringRequis

Le titre de la session (par défaut si non fourni).

post
/mobility-assessment/sessions/

Récupérer la configuration de rapport sauvegardée pour une session

get

Renvoie les paramètres d'affichage actuels pour la session spécifiée d'angle articulaire.

  • Paramètre de Chemin

    • session_id (string, requis) : Identifiant de la session à interroger.

Réponses

  • 200 OK : La configuration a été trouvée et renvoyée.

    • shown_angles : Tableau des clés d'angle articulaire sélectionnées par l'utilisateur.

    • comments : Map de notes libres clé par angle.

  • 401 Non autorisé : Aucune information d'identification d'authentification valide fournie. - 403 Interdit : Vous n'êtes pas autorisé à voir les paramètres de cette session. - 404 Non trouvé : L'ID de session ne correspond à aucune configuration stockée. - 500 Erreur interne du serveur : Une erreur inattendue s'est produite sur le serveur.

Autorisations
AuthorizationstringRequis

Entrez votre token Bearer (authentification Firebase) au format : Bearer

Paramètres de chemin
session_idanyRequis
Réponses
200

Configuration récupérée avec succès.

application/json
shown_anglesstring[]Requis

Clés d'angle articulaire sélectionnées

get
/mobility-assessment/sessions/{session_id}/joint-mobility-config/

Créer ou mettre à jour la configuration de rapport pour une session

post

Sauvegarde vos paramètres d'affichage choisis pour la session spécifiée d'angle articulaire.

  • Paramètre de Chemin

    • session_id (string, requis) : Identifiant de session.

  • Corps de la Requête

    • shown_angles (array[string], optionnel) : Clés d'angle articulaire que vous souhaitez afficher.

    • comments (object[string→string], optionnel) : Toutes notes par angle.

Réponses

  • 200 OK : Configuration sauvegardée avec succès (renvoie les paramètres stockés). - 400 Requête incorrecte : Un ou plusieurs champs étaient invalides — voir errors pour les détails. - 401 Non autorisé : Aucune information d'identification d'authentification valide fournie. - 403 Interdit : Vous n'êtes pas autorisé à modifier les paramètres de cette session. - 500 Erreur interne du serveur : Une erreur inattendue s'est produite lors de la sauvegarde.

Autorisations
AuthorizationstringRequis

Entrez votre token Bearer (authentification Firebase) au format : Bearer

Paramètres de chemin
session_idanyRequis
Corps
shown_anglesstring[]Optionnel

Angles à afficher

Example: ["shoulder_angle","ankle_angle"]
Réponses
200

Configuration sauvegardée et renvoyée.

application/json
shown_anglesstring[]Requis

Liste mise à jour des angles affichés

post
/mobility-assessment/sessions/{session_id}/joint-mobility-config/

Créer des fils de recommandations

post

Créer des fils de recommandations

Ce point de terminaison génère des fils de recommandations personnalisés basés sur le rapport Overhead Squat de l'utilisateur pour une session spécifique. Ces fils peuvent être utilisés pour fournir des conseils personnalisés, des suggestions d'entraînement ou des insights de performance à l'utilisateur. Exemple d'utilisation : Envoyez une requête POST à /mobility-assessment/sessions/{session_id}/recommendation/ où {session_id} est l'identifiant unique de la session. Paramètres :

  • session_id (string, requis) : L'identifiant unique de la session pour laquelle les fils de recommandations doivent être créés. Structure de la Réponse : Lors d'une requête réussie, le point de terminaison renvoie un objet JSON contenant les IDs de fils mappés à leurs métriques respectives du rapport Overhead Squat. Exemple de Réponse :

    "ankle_dorsiflexion": "thread_boQ0PSivWvPHIx4MQ02HqSEX",
    "hip_abduction": "thread_eoTqfX3qWuT2IrEhZpGcem7L",
    "hip_flexion": "thread_0pJjWIs5ybuo5gzRJd1ykgaB",
    "knee_flexion": "thread_8gp2spSn8XasAOafDwwzw5QT",
    "knee_movement": "thread_8gp2spSn8XasAOafDwwzw5QT",
    "final_summary": "thread_P3MqG76m9s6qlYwINJrlNomB"
} ```
**Note :**
- Assurez-vous que le `session_id` fourni est valide et correspond à une session existante dans le système. - L'utilisateur doit avoir un plan de paiement actif pour accéder à cette fonctionnalité.
Autorisations
AuthorizationstringRequis

Entrez votre token Bearer (authentification Firebase) au format : Bearer

Paramètres de chemin
session_idanyRequis
Réponses
200

Fils créés avec succès.

application/json

Un dictionnaire mappant chaque métrique à son ID de fil correspondant.

ankle_dorsiflexionstringRequis

Identifiant unique pour le fil de recommandation de dorsiflexion de cheville.

hip_abductionstringRequis

Identifiant unique pour le fil de recommandation d'abduction de hanche.

hip_flexionstringRequis

Identifiant unique pour le fil de recommandation de flexion de hanche.

knee_flexionstringRequis

Identifiant unique pour le fil de recommandation de flexion de genou.

knee_movementstringRequis

Identifiant unique pour le fil de recommandation de mouvement de genou.

final_summarystringRequis

Identifiant unique pour le fil de recommandation de résumé final.

post
/mobility-assessment/sessions/{session_id}/recommendation/

Générer un rapport Overhead Squat

post

Génère ou récupère un rapport détaillé Overhead Squat pour un session_id donné. Ce point de terminaison consolide les métriques de session, les organise en groupes et intègre les métadonnées utilisateur et session.

Paramètre de Chemin

  • session_id (string, requis) : L'identifiant unique de la session Overhead Squat.

Paramètre de Requête

  • demo (booléen, optionnel) : Définir à true pour récupérer le rapport de démonstration Overhead Squat au lieu d'un réel.

Réponse de Succès (HTTP 200)

Renvoie un objet JSON contenant :

  • grouped_data (object) : Organisé par groupes de métriques (ex., hip_flexion, knee_flexion). Chaque groupe a :

    • metrics (object) : Paires clé-valeur de résultats de métriques agrégées.

    • graph_data (object) : Tableaux de données numériques pour traçage de graphiques.

  • graph_timestamps (array[number]) : Liste d'horodatages (en millisecondes) correspondant à chaque donnée de graphique. - knee_movement_phases (object) : URLs d'images de visualisation montrant différentes vues des phases de mouvement du genou.

    • left (string) : URL pour l'image de vue gauche.

    • right (string) : URL pour l'image de vue droite.

    • front (string) : URL pour l'image de vue frontale.

  • user_info (object, optionnel) : Détails de base de l'utilisateur associé à la session. - exercise (string) : Le nom/type d'exercice (ex., Overhead Squat). - report_comments (object, optionnel) : Commentaires détaillés sur différents aspects du mouvement. - output_quality (object, optionnel) : Toute information supplémentaire sur la qualité ou le score. - date (string, format=JJ/MM/AAAA) : La date de création ou de traitement de la session.

Exemple de Réponse de Succès

Autorisations
AuthorizationstringRequis

Entrez votre token Bearer (authentification Firebase) au format : Bearer

Paramètres de chemin
session_idanyRequis
Paramètres de requête
demobooleanOptionnel

Définir à true pour récupérer le rapport de démonstration Overhead Squat au lieu d'un réel.

Réponses
200

Rapport Overhead Squat généré/récupéré avec succès.

application/json
graph_timestampsnumber[]Requis

Une liste d'horodatages (en millisecondes) correspondant à chaque donnée de graphique.

exercisestringRequis

Nom/type de l'exercice (ex., 'Overhead Squat').

datestringRequis

Une chaîne représentant la date de la session au format JJ/MM/AAAA.

post
/mobility-assessment/sessions/{session_id}/report/

Récupérer un résumé Overhead Squat

get

Récupère un résumé de haut niveau des données de session Overhead Squat identifiées par son session_id. Ce point de terminaison renvoie des métriques groupées (ex., hip_flexion, knee_flexion) sans données de graphique détaillées, ainsi que des métadonnées utilisateur et session optionnelles.

Paramètre de Chemin

  • session_id (string, requis) : L'identifiant unique de la session Overhead Squat.

Paramètre de Requête

  • demo (booléen, optionnel) : Définir à true pour récupérer le résumé de démonstration pré-généré Overhead Squat au lieu d'un réel.

Réponse de Succès (HTTP 200)

Renvoie un objet JSON contenant :

  • grouped_data (object) : Métriques de haut niveau groupées par catégorie (ex., hip_flexion, knee_flexion). Chaque groupe contient des clés de métriques, chacune mappée à des valeurs numériques.

    {
  "hip_flexion": {
    "left_hip_flexion": 84.0,
    "right_hip_flexion": 80.0,
    "hip_flexion_asymmetry": 4.0
  }
}

  • knee_movement_phases (object) : URLs d'images de visualisation montrant différentes vues des phases de mouvement du genou.

    • left (string) : URL pour l'image de vue gauche.

    • right (string) : URL pour l'image de vue droite.

    • front (string) : URL pour l'image de vue frontale.

  • user_info (object, optionnel) : Contient des champs liés à l'utilisateur, ex., poids, display_name, email. - exercise (string) : Le nom de l'exercice (ex., Overhead Squat). - output_quality (object, optionnel) : Contient des valeurs ou indices numériques (ex., mobility_index). - summary (object, optionnel) : Contient des commentaires détaillés sur différents aspects du mouvement. - date (string, format=JJ/MM/AAAA) : La date de création/traitement de cette session.

Exemple de Réponse de Succès

Autorisations
AuthorizationstringRequis

Entrez votre token Bearer (authentification Firebase) au format : Bearer

Paramètres de chemin
session_idanyRequis
Paramètres de requête
demobooleanOptionnel

Définir à true pour récupérer le résumé de démonstration pré-généré Overhead Squat au lieu d'un réel.

Réponses
200

Résumé Overhead Squat récupéré avec succès.

application/json
exercisestringRequis

Le nom/type de l'exercice, ex. 'Overhead Squat'.

datestringRequis

Date de la session au format 'JJ/MM/AAAA'.

get
/mobility-assessment/sessions/{session_id}/summary/

Générer des fils de résumé pour une session

post

Générer des fils de résumé

Ce point de terminaison génère des fils de résumé pour une session donnée basés sur des blocs de résumé prédéfinis et des métriques. Exemple d'utilisation : Envoyez une requête POST à /mobility-assessment/sessions/{session_id}/summary/ où {session_id} est l'identifiant unique de la session. Paramètres :

  • session_id (string, requis) : L'identifiant unique de la session pour laquelle les fils de résumé doivent être générés. Structure de la Réponse : Lors d'une requête réussie, le point de terminaison renvoie un objet JSON mappant chaque métrique à son ID de fil correspondant. Exemple de Réponse :

    "hip_flexion": "thread_x7C4p5ancmeluBmEJgmFwXra",
    "hip_abduction": "thread_lth8oxKfnktwne9ryGZefd6V",
    "knee_flexion": "thread_cM4jY2RLfVNeFIImJXaIinMK",
    "knee_movement": "thread_8gp2spSn8XasAOafDwwzw5QT",
    "ankle_dorsiflexion": "thread_EIwgj822ZHtGCTMucHZDtatH",
    "final_summary": "thread_2XwSNDNrclHgakiBFm4o9K65"
} ```
**Notes :**
- Assurez-vous que le `session_id` fourni est valide et correspond à une session existante dans le système. - L'utilisateur doit avoir les permissions nécessaires pour générer des fils de résumé.
Autorisations
AuthorizationstringRequis

Entrez votre token Bearer (authentification Firebase) au format : Bearer

Paramètres de chemin
session_idanyRequis
Paramètres de requête
measurement_systemstring · enumOptionnel

Système de mesure : 'métrique' ou 'impérial'

Valeurs possibles:
Réponses
post
/mobility-assessment/sessions/{session_id}/summary/
PrécédentMusculationSuivantFichiers HTML

Mis à jour

Ce contenu vous a-t-il été utile ?