ForHosting KIT · Strumenti per sviluppatori

Coda vaccinale Paesi Bassi

I Paesi Bassi non hanno offerto le prime dosi di COVID-19 a tutti insieme. Il Consiglio della salute dei Paesi Bassi (Gezondheidsraad) e il RIVM hanno ordinato il personale e i residenti dell’assistenza di lunga durata, poi gli adulti più anziani dal più vecchio al più giovane, i pazienti ad alto rischio medico il cui rischio rassomigliava a quello di persone intorno ai settant’anni, il resto delle persone di sessant’anni e oltre, gli altri operatori sanitari, gli adulti con indicazione medica e infine il resto della popolazione per età decrescente, affinché l’offerta scarsa raggiungesse per primi i gruppi a rischio più alto. Questo strumento di coda vaccinale dei Paesi Bassi applica quella strategia olandese di priorità all’età e all’appartenenza a un gruppo a rischio e restituisce il gruppo di priorità assegnato. L’età deve essere un intero non negativo; se manca, è negativa, frazionaria o non numerica, la richiesta fallisce con invalid_input e non viene addebitata. L’appartenenza a un gruppo a rischio ha un valore predefinito documentato, così una sola età produce comunque un gruppo. La stessa logica isomorfa alimenta il widget gratuito del browser e l’API prepagata a $0.002 per elemento riuscito, così aule, divulgatori e team di prodotto fissano lo stesso JSON senza chiamare un canale di prenotazione RIVM o GGD in tempo reale.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Come si usa

Inserisci i dati nel modulo qui sopra. Lo strumento li controlla prima del calcolo e mostra il risultato nella stessa pagina.

Controlla i dati

Segui le etichette e le unità indicate per ogni campo. Se manca qualcosa o un valore non è ammesso, la pagina indica cosa correggere.

Ripeti il calcolo o automatizzalo

Usa lo strumento web per controlli singoli e l’API quando vuoi integrare la stessa capacità in un flusso automatizzato.

Casi d'uso

Ottieni subito una risposta

Inserisci una serie di valori e visualizza il risultato senza preparare un foglio di calcolo o uno script.

Confronta gli scenari

Modifica un valore alla volta e ripeti il calcolo per capire cosa cambia il risultato.

Automatizza le attività ripetute

Usa l’API quando lo stesso calcolo deve essere eseguito nel tuo prodotto o flusso.

Domande frequenti

Come assegna un gruppo di priorità lo strumento di coda vaccinale dei Paesi Bassi?

Ordina age e risk_group (none, care_staff, care_resident, high_risk, medical_indication o healthcare) rispetto all’ordine COVID-19 Gezondheidsraad/RIVM del 2021 per i Paesi Bassi e restituisce il gruppo coincidente di priorità più alta (1-15).

Che cosa accade se l’età non è un intero non negativo?

L’attività fallisce con invalid_input. L’età deve essere un numero intero di anni da 0 a 120. Un’età assente, negativa, frazionaria o non numerica non viene addebitata.

Quali valori di risk_group corrispondono a quali gruppi olandesi?

care_staff è il gruppo 1. care_resident è il gruppo 2. high_risk è il gruppo 5. healthcare è il gruppo 8. medical_indication è il gruppo 9 per le età 18–59 quando non si applica un gruppo superiore. none non aggiunge fetta di gruppo a rischio; l’età assegna comunque un gruppo. Quando coincidono più fette, viene restituito il gruppo di priorità più alta.

Un flag medico ad alto rischio assegna sempre il gruppo 5?

Solo quando non si applica un gruppo superiore. Gli operatori dell’assistenza di lunga durata restano il gruppo 1. I residenti di case di cura e di assistenza alla disabilità restano il gruppo 2. Le persone di 90 anni e oltre restano il gruppo 3, e quelle di 80–89 anni restano il gruppo 4. Un medical_indication senza high_risk assegna il gruppo 9 solo per le età 18–59.

Quanto costa il calcolatore di coda vaccinale dei Paesi Bassi?

Lo strumento del browser è gratuito. Le richieste API usano saldo prepagato a $0.002 per chiamata riuscita; un ingresso non valido non viene addebitato.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/health/vaccine-queue-netherlands

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/health/vaccine-queue-netherlands \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"age":72}'

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

import os, requests

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

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

body := bytes.NewBufferString(`{"age":72}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/health/vaccine-queue-netherlands", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "age": 72
}

Esempio di risposta

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

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →