API Dosimétrie RIV — informations utiles

Cette page est destinée aux personnes qui veulent envoyer une requête à l’API et récupérer la réponse. Elle ne contient pas d’informations de débogage interne.

Endpoints utiles

• GET /api/config : liste des radiopharmaceutiques, options de cures, mode par défaut.
• POST /api/calculate : calcule les durées de restriction.
• GET /api/public-config : clé publique reCAPTCHA (page contact).
• POST /api/contact : envoi d’un message de contact.
• GET /health : vérification de disponibilité du service.

Payload attendu pour POST /api/calculate

{
  "calculation_mode": "sfmn",
  "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
}

Règles importantes par cas

• Cas standard : fournir dose_rate et patient_size_cm.
• iode131_benin : fournir benign_activity_mbq et benign_fixation_pct (en %). dose_rate est ignoré.
• non_defini (mode local) : fournir aussi user_period_days strictement positif.
• cure_count : utile pour psma_177lu (1/4/6) et lutetium177_net (1/4). Pour radium223 : 1 uniquement.

Réponse attendue (succès)

{
  "ok": true,
  "calculation_mode": "sfmn",
  "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
  }
}

Réponse en cas d’erreur de validation

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

Isotopes disponibles (isotope_code)