API multi-valico Online
Recupera lo stato della coda e la freschezza dei dati per fino a 20 punti di controllo in una singola richiesta. La quota viene calcolata come ⌈(N PPID × sotto-prodotti) / 2⌉ — 50% più economico rispetto alle chiamate individuali equivalenti. Utilizza include=queue,update-info per ottenere entrambi gli insiemi di dati contemporaneamente.
GET https://nakordoni.eu/api/v1/data/multi
— classe di quota: heavy
| Parametro | Descrizione |
|---|---|
ppids | Comma-separated list of checkpoint IDs (required, max 20) — e.g. id_2,id_13,id_15,id_59 |
include | Comma-separated sub-products to include: queue, update-info (default: queue,update-info) |
lang | Language code for checkpoint names in queue responses (default: en) |
Campi della risposta — all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.
| Campo | Descrizione |
|---|---|
data.<ppid> | One object per requested checkpoint, keyed by ppid — not an array. A ppid you asked for that we do not monitor is absent. |
data.<ppid>.queue | Present when include contains queue: found, queue_now, wait_min, wait_status, trend_percent, trend_direction, age_min, freshness, name, updated_at. |
data.<ppid>.update_info | Present when include contains update-info: found, timestamp, datetime, timezone, age_seconds, age_minutes, freshness, queue_now. |
meta.ppids_requested | How many ppids the call asked for (envelope level, beside data). |
meta.units_consumed | Quota units this call actually cost — ⌈(ppids × sub-products) / 2⌉. |
curl "https://nakordoni.eu/api/v1/data/multi?ppids=id_2,id_13,id_15&include=queue,update-info&lang=en" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Accedi come sviluppatore per provare questo endpoint dal vivo nella sandbox — 50 chiamate di prova gratuite al giorno. Accedi