Intégration côté serveur
Toutes les routes de cette page s'appellent depuis votre serveur, avec votre clé secrète dans l'en-tête Authorization: Bearer wu_sk_…. Ces routes n'acceptent aucun appel venant d'un navigateur (pas de CORS).
Créer une session
POST /v1/sessions
| Champ | Obligatoire | Description |
|---|---|---|
zone |
oui | Zone traitée : thoracolumbar_spine, cervical_spine, shoulder, knee, peripheral_nerve, pelvic_perineal (questionnaires par zone) |
patient.sex |
oui | male ou female (choix de l'avatar) |
patient.height_cm |
oui | 50 à 250 — sert à convertir les surfaces en cm² |
patient.weight_kg |
oui | 2 à 400 — sert à choisir la silhouette (tranche d'IMC) |
locale |
non | Locale « langue-PAYS » parmi celles autorisées pour votre compte (fr-FR, en-GB…). Par défaut, votre locale par défaut |
modules |
oui | ["cartography"], ["questionnaires"] ou les deux. Le MCRi exige les deux |
reference |
non | Votre identifiant de dossier (64 caractères imprimables au plus). Opaque : imprimé sur le PDF, jamais interprété ni conservé |
resume_bundle |
non | Un paquet de reprise reçu précédemment, pour rouvrir une évaluation (reprise) |
options.session_pin |
non | none, optional (défaut) ou required : code de session demandé avant de remettre l'appareil au patient |
options.show_results |
non | Afficher le résultat sur l'écran de fin du composant. Par défaut, le réglage de votre compte |
Aucune donnée d'identité n'est attendue ni acceptée : tout champ inconnu est refusé (400).
- Durée de vie : une session expire 2 heures après sa création.
- Idempotence : l'en-tête
Idempotency-Key(128 caractères au plus) rejoue la même réponse pendant 24 heures, sans créer de doublon ni consommer de quota. - Quotas : un nombre de sessions par jour et de soumissions par minute est fixé pour votre compte. Au-delà, l'API répond
429avec l'en-têteRetry-After.
Suivre une session
GET /v1/sessions/{id} renvoie l'état de la session (created, in_progress, completed), sa zone, ses modules et ses dates. Il ne renvoie aucune donnée de santé.
Récupérer le résultat
GET /v1/sessions/{id}/result
| Réponse | Cas |
|---|---|
200 |
Le résultat (détail), son report_url et le resume_bundle |
409 result_not_ready |
L'évaluation n'a pas encore été envoyée |
410 result_expired |
Le résultat a été supprimé : 15 min après la première récupération, ou 15 min après l'envoi |
404 session_not_found |
Session inconnue, purgée, ou appartenant à un autre compte |
Conseil : récupérez le résultat dès l'événement completed reçu par votre page, puis enregistrez-le chez vous. Wave Up ne le garde pas.
Rapport PDF
GET /v1/sessions/{id}/report.pdf renvoie le rapport co-signé, avec votre logo et celui de Wave Up. Avec ?locale=en-GB (une locale autorisée), le rapport est recalculé dans cette langue à partir du paquet de reprise.
Purger une session
DELETE /v1/sessions/{id} supprime immédiatement la session et son résultat (204).