API Dosimétrie RIV

Pour envoyer une requête à l'API et lire la réponse.

Endpoints

Payload — POST /api/calculate

{
  "isotope_code": "iode131_25_fixation",
  "dose_rate": 9.9,
  "patient_size_cm": 150,
  "user_period_days": null,
  "user_hours_1": null,
  "user_distance_1": null,
  "user_hours_2": null,
  "user_limit": null,
  "benign_activity_mbq": null,
  "benign_fixation_pct": null,
  "cure_count": 1,
  "provider": "nom-de-votre-logiciel"
}

Règles

Réponse (succès)

{
  "ok": true,
  "selected": { "api_code": "...", "label": "..." },
  "cure_count": 1,
  "computed_dose_rate": 9.9,
  "effective_days": 0.67,
  "effective_hours": 16,
  "errors": [],
  "recommendations_days": {
    "conjoint_plus_60": 0,
    "conjoint_moins_60": 0,
    "conjointe_enceinte": 0,
    "transport_commun": 0,
    "enfant_moins_3_ans": 0,
    "enfant_3_11_ans": 0,
    "collegues_travail": 0,
    "scenario_utilisateur": null
  },
  "rows": [
    { "audience_code": "conjoint_plus_60", "label": "...", "condition": "...", "value": 0 }
  ]
}

rows reprend les valeurs de recommendations_days avec un libellé et un texte de condition prêts à afficher pour chaque scénario.

Recommandation d'intégration : identifiez toujours un scénario par son audience_code (ou par sa clé dans recommendations_days), jamais par le texte de label ou de condition. Ces textes sont faits pour l'affichage, peuvent être reformulés d'une version à l'autre du site sans changer le sens ni les valeurs, et ne doivent pas servir de clé de recherche. Les codes (conjoint_plus_60, transport_commun...) et les noms des champs de la réponse sont, eux, stables.

Réponse (erreur de validation)

{
  "ok": false,
  "error": { "code": "VALIDATION_ERROR", "message": "...", "reason": "..." },
  "errors": ["..."]
}

Isotopes disponibles (isotope_code)

LibelléCode API
Iobenguane (MIBG) · iode 131mibg_131i
Iode 131 (0 %) · néoplasieiode131_0_fixation
Iode 131 (5 %) · néoplasie oligométastatiqueiode131_5_fixation
Iode 131 (25 %) · néoplasie multimétastatiqueiode131_25_fixation
Iode 131 · indication non néoplasiqueiode131_benin
Lipiodol marqué à l'iode 131lipiodol_131i
Lutétium 177 · PSMApsma_177lu
Lutétium 177 · tumeurs neuroendocrineslutetium177_net
Microsphères d'holmium 166microspheres_166ho
Microsphères d'yttrium 90microspheres_90y
Radiosynoviorthèse · erbium 169synovectomie_169er
Radiosynoviorthèse · rhénium 186synovectomie_186re
Radiosynoviorthèse · yttrium 90synovectomie_90y
Radium 223radium223
Personnalisénon_defini

Scénarios d'exposition (audience_code)

Liste lue en direct sur GET /api/config : elle reflète toujours le moteur de calcul actif.

LibelléCode APIHypothèse
Chargement…

Authentification (clé d'API, si l'administrateur l'exige)

Tout appel extérieur à POST /api/calculate peut devoir présenter une clé d'API propre à votre logiciel ou service, fournie par l'administrateur du site : elle est obligatoire uniquement si l'administrateur l'exige (réglage du site ; sinon les appels sans clé sont acceptés). Transmettez-la dans l'en-tête HTTP X-API-Key (ou Authorization: Bearer <clé>), jamais dans l'adresse, en HTTPS uniquement :

POST /api/calculate
Content-Type: application/json
X-API-Key: rdv_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx