ForHosting KIT · Outils pour développeurs

Cohorte JCVI du vaccin COVID au Royaume-Uni

Le Royaume-Uni n'a pas offert à chaque adulte une première dose contre la COVID-19 le même matin d'hiver.

● BetaGratuit · dans votre navigateur

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Le Joint Committee on Vaccination and Immunisation a publié neuf cohortes prioritaires de la phase 1 afin que les premiers flacons aillent aux résidents d'établissements pour personnes âgées et à leurs soignants, puis aux adultes les plus âgés, aux soignants de santé et d'action sociale de première ligne et aux personnes cliniquement extrêmement vulnérables. Ce calculateur de file vaccinale britannique attribue ce numéro de cohorte JCVI à partir de trois faits que vous connaissez déjà : l'âge en années révolues, la classe d'occupation et la vulnérabilité clinique. La résidence facultative en établissement pour personnes âgées marque le groupe 1 pour les aînés. Un âge négatif est rejeté comme entrée invalide au lieu d'être replié en valeur absolue. Le widget gratuit du navigateur et l'API prépayée partagent un seul module isomorphe, de sorte que les corrigés de cours et les pipelines automatisés s'accordent toujours. Traitez chaque résultat comme une reconstruction éducative du cadre séquencé de 2020–21, jamais comme une réservation NHS, une ordonnance médicale ou un substitut à un GP ou à un service local de vaccination. Les appels API réussis utilisent le $0.002 publié par élément ; une 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

Comment la cohorte prioritaire du vaccin JCVI contre la COVID-19 au Royaume-Uni est-elle attribuée ?

Envoyez age en années, occupation (care_home, health_social_care ou other) et clinical_vulnerability (cev, cv ou none). L'indicateur facultatif care_home_resident vaut false par défaut. L'API parcourt la cascade de la phase 1 du JCVI et renvoie le numéro de cohorte de plus haute correspondance plus eligibility_status.

Que se passe-t-il si l'âge est négatif ?

La tâche échoue avec invalid_input. Les années d'âge ne peuvent pas être négatives, donc le calculateur ne prend pas de valeur absolue et la requête n'est pas facturée.

Que signifient les numéros de cohorte JCVI ?

Les cohortes 1 à 9 sont les groupes prioritaires originaux de la phase 1, le 1 étant le plus élevé. La cohorte 1 concerne les résidents d'établissements pour personnes âgées et leurs soignants ; la 2 l'âge 80+ et les soignants de santé et d'action sociale de première ligne ; la 3 l'âge 75+ ; la 4 l'âge 70+ et les adultes cliniquement extrêmement vulnérables ; la 5 l'âge 65+ ; la 6 les âges 16–64 avec affections sous-jacentes ; la 7–9 les adultes restants 60+, 55+ et 50+. La cohorte 0 signifie que le profil n'est dans aucun de ces neuf groupes.

Cet outil réserve-t-il un rendez-vous vaccinal NHS au Royaume-Uni ?

Non. C'est une reconstruction éducative du cadre séquencé de la phase 1 du JCVI de 2020–21. Il n'appelle pas un portail NHS, ne réserve pas un créneau de clinique et ne donne pas de conseil médical.

Combien coûte le calculateur de file vaccinale COVID du Royaume-Uni ?

L'outil du navigateur est gratuit. Les requêtes API utilisent le solde prépayé du KIT à $0.002 par appel réussi ; une 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/vaccine-queue-uk

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/vaccine-queue-uk \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"age":82,"occupation":"other","clinical_vulnerability":"none"}'

const res = await fetch("https://api.kit.forhosting.com/health/vaccine-queue-uk", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "age": 82,
    "occupation": "other",
    "clinical_vulnerability": "none"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/health/vaccine-queue-uk",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "age": 82,
    "occupation": "other",
    "clinical_vulnerability": "none"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/health/vaccine-queue-uk", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"age":82,"occupation":"other","clinical_vulnerability":"none"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"age":82,"occupation":"other","clinical_vulnerability":"none"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/health/vaccine-queue-uk", 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

{
  "age": 82,
  "occupation": "other",
  "clinical_vulnerability": "none"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "health.vaccine_queue_uk",
  "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.

Limites

max_age 120

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 →