Wave Up Developers EN

Les résultats

Le résultat (GET /v1/sessions/{id}/result) est un JSON aux clés anglaises. Les textes (questions, réponses, noms) sont dans la langue de la locale de passation. Les valeurs sont arrondies au dixième.

{
  "session_id": "ses_UZaJ3Siu2NWNtHBxRaicid4T",
  "reference": "DOSSIER-2026-0042",
  "computed_at": "2026-10-04T12:41:07.000Z",
  "zone": "thoracolumbar_spine",
  "locale": "fr-FR",
  "versions": { "api": "1.0.0", "engine": "1.0.0", "stats_algo": 3, "mcri_algo": 1, "questionnaires": { "vas_global": 1, "eq5d": 1, "hads": 1, "odi": 1 } },
  "cartography": {
    "no_pain": false,
    "pain_surface": { "cm2": 205.5, "percent_of_body": 2 },
    "by_intensity": { "mild": { "cm2": 108.8, "percent": 52.9 }, "moderate": { "cm2": 0, "percent": 0 }, "severe": { "cm2": 96.7, "percent": 47.1 }, "very_severe": { "cm2": 0, "percent": 0 } },
    "by_typology": { "nociceptive": { "cm2": 0, "percent": 0 }, "trigger": { "cm2": 4.6, "percent": 2.2 }, "burning": { "cm2": 50.3, "percent": 24.5 }, "tingling": { "cm2": 0, "percent": 0 }, "allodynia": { "cm2": 0, "percent": 0 }, "hypoesthesia": { "cm2": 0, "percent": 0 } },
    "by_family": { "mechanical": { "cm2": 4.6, "percent": 2.2 }, "neuropathic": { "cm2": 50.3, "percent": 24.5 } },
    "untyped": { "cm2": 155.2, "percent": 75.5 },
    "hypoesthesia_outside_pain_cm2": 0,
    "images": { "intensity_front": "data:image/jpeg;base64,…", "intensity_back": "data:image/jpeg;base64,…", "typology_front": "data:image/jpeg;base64,…", "typology_back": "data:image/jpeg;base64,…" }
  },
  "questionnaires": [
    { "id": "hads", "name": "HADS", "version": 1, "locale": "fr-FR", "scores": { "anxiety": 12, "depression": 10, "total": 22 }, "score_ranges": { "anxiety": [0, 21], "depression": [0, 21], "total": [0, 42] }, "answers": [{ "item": "1", "question": "Je me sens tendu(e) ou énervé(e) :", "answer": "Souvent" }], "copyright": null }
  ],
  "mcri": { "status": "computed", "score": 5.1, "branches": { "mapping": 9.4, "functional_capacity": 8, "eq5d": 6.1, "hads": 4.8, "vas": 5.5 }, "radar_image": "data:image/png;base64,…" },
  "report_url": "https://sandbox.api.waveup-health.fr/v1/sessions/ses_UZaJ3Siu2NWNtHBxRaicid4T/report.pdf",
  "resume_bundle": "wub1.k2026.…"
}

Cartographie

Champ Signification
pain_surface Surface douloureuse totale (cm²) et part du corps (%)
by_intensity Surface par niveau : percent = part de la surface douloureuse
by_typology Surface de chaque typologie dans la zone douloureuse : percent = part de la zone douloureuse
by_family Mécanique (nociceptive + trigger) et neuropathique (union des 4 typologies)
untyped Zone douloureuse sans typologie renseignée
hypoesthesia_outside_pain_cm2 Hypoesthésie dessinée hors de la zone douloureuse (seule typologie possible hors zone)
images JPEG : intensité seule, puis typologies seules, de face et de dos. null quand la couche n'a aucun tracé

Nociceptive et trigger s'excluent : un trigger dessiné sur du nociceptif le remplace. no_pain: true signifie « Sans douleur » : les surfaces sont nulles et le MCRi reste calculable.

Questionnaires

scores contient les scores calculés : total, anxiety/depression (HADS), pcs/mcs (SF-12), et les niveaux par dimension, vas et index pour l'EQ-5D. Il est vide quand le score n'est pas calculable. score_ranges donne l'échelle de chaque score. L'index EQ-5D suit le jeu de valeurs fixé pour votre compte (value_set : fr ou us). Aucun seuil d'interprétation clinique n'est appliqué.

MCRi

Score de 0 à 10, 10 = meilleur état, avec ses 5 branches (mapping, functional_capacity, eq5d, hads, vas) et l'araignée en PNG. Quand une donnée manque, status vaut missing et missing liste ce qui manque :

{ "status": "missing", "missing": [{ "kind": "item", "questionnaire": "sf12", "item": "1" }] }

kind vaut cartography, vas, questionnaire ou item. Les deux briques (cartographie et questionnaires) sont nécessaires.

Versions

versions indique la version de l'API, du moteur de calcul, des algorithmes (surfaces, MCRi) et de chaque questionnaire. Conservez-les avec le résultat : un changement d'algorithme est annoncé dans le journal des versions et n'est jamais appliqué rétroactivement.

Rapport PDF co-signé

report_url (même clé que l'API) donne un PDF de 3 à 4 pages :

Il ne contient aucune donnée d'identité, hormis votre référence opaque.