ForHosting KIT · Outils pour développeurs

Calculateur STOP-BANG

Le questionnaire STOP-BANG est un dépistage à huit items qui estime le risque d'apnées obstructives du sommeil à partir de réponses oui ou non.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Chaque constat vaut un point : ronflement bruyant, fatigue diurne, pauses respiratoires observées, hypertension connue ou traitée, indice de masse corporelle supérieur à trente-cinq, âge de plus de cinquante ans, cou large et sexe masculin. Le total entier occupe donc l'intervalle fermé de zéro à huit. Les bandes publiées classent zéro à deux en risque faible, trois et quatre en risque intermédiaire, et cinq à huit en risque élevé de SAOS. Cette capacité applique cette règle publiée comme fonction pure : vous envoyez huit booléens et recevez le score avec la bande de risque. Les réponses manquantes sont rejetées en entrée invalide plutôt que traitées comme non. Le widget gratuit du navigateur et l'API prépayée partagent un seul module isomorphe, de sorte que les corrigés de cours, les feuilles de travail et les pipelines automatisés s'accordent toujours. Les appels API réussis utilisent le $0.002 publié par élément ; l'entrée invalide n'est pas facturée.

Comment l’utiliser

Saisissez vos données dans le formulaire ci-dessus. L’outil les vérifie avant le calcul et affiche le résultat sur la même page.

Vérifiez vos données

Suivez les libellés et les unités de chaque champ. Si une valeur manque ou sort de la plage autorisée, la page indique quoi corriger.

Relancez le calcul ou automatisez-le

Utilisez l’outil web pour les vérifications ponctuelles et l’API pour intégrer la même capacité à un flux automatisé.

Cas d’usage

Obtenez une réponse maintenant

Saisissez un jeu de valeurs et consultez le résultat sans créer de feuille de calcul ni de script.

Comparez des scénarios

Modifiez une valeur à la fois et relancez le calcul pour voir ce qui influence le résultat.

Automatisez les tâches répétées

Utilisez l’API lorsque le même calcul doit s’exécuter dans votre produit ou votre flux.

Questions fréquentes

Qu'est-ce que le score STOP-BANG ?

STOP-BANG est un dépistage à huit items de l'apnée obstructive du sommeil. Un point pour ronflement bruyant, fatigue diurne, apnée observée, hypertension, IMC supérieur à 35, âge supérieur à 50, cou supérieur à 40 cm et sexe masculin. Le total va de 0 à 8.

Comment les huit réponses deviennent-elles un niveau de risque ?

Chaque oui vaut un point. Les scores 0–2 correspondent à un risque faible de SAOS, 3–4 à un risque intermédiaire et 5–8 à un risque élevé. La réponse indique le score entier et la bande de risque. C'est la règle de dépistage publiée, non un diagnostic d'étude du sommeil.

Que se passe-t-il si l'une des huit réponses manque ?

La requête échoue avec invalid_input en nommant le champ manquant. Un blanc n'est pas traité comme non, car cela sous-noterait le questionnaire en silence.

Dois-je envoyer l'IMC, l'âge et le cou comme nombres ?

Non. Envoyez bmi_over_35, age_over_50 et neck_large comme booléens que vous avez déjà tranchés à partir de ces mesures. L'IMC numérique, les années ou les centimètres appartiennent à d'autres calculateurs ; cette page note les huit items oui/non.

Combien coûte le calculateur STOP-BANG ?

L'outil du navigateur est gratuit et s'exécute en local. Les requêtes API utilisent le solde prépayé KIT à $0.002 par élément réussi ; l'entrée invalide n'est pas facturée.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/health/stop-bang

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/health/stop-bang \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/health/stop-bang", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/health/stop-bang",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/health/stop-bang", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"items":["valor-1","valor-2"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/health/stop-bang", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "health.stop_bang",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →