API e Statistikave Orare të Pikës Online
Statistika historike orare të radhës sipas pikës dhe datës: 24 vlera orare, mesatare/min/maks ditore, orët më të ngarkuara dhe më të qeta, krahasim ditë pas dite.
GET https://nakordoni.eu/api/v1/data/stats
— klasa e kuotës: heavy
| Parametri | Përshkrimi |
|---|---|
ppid | ID e pikës së kontrollit, p.sh. id_13 (shih /api/v1/data/checkpoints) |
date | YYYY-MM-DD (parazgjedhje: dje) |
compare | 1 = përfshi ditën e mëparshme + diferencën |
lang | Kodi i gjuhës (parazgjedhje uk) |
Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.
| Fusha | Përshkrimi |
|---|---|
data.ppid | Checkpoint the statistics belong to, with checkpoint.name and checkpoint.source_url. |
data.date | The day covered, in the checkpoint's timezone (data.timezone); unit says what the numbers count. |
data.hourly[] | 24 elements: hour, value, data_points (observations behind that hour). value is null for an hour with no data. |
data.labels | Hour labels for the 24 buckets; values is the bare value series, aligned with them. |
data.daily | Whole-day rollup: avg, min, max, total, hours_with_data. |
data.peak | Busiest hour of the day, and quietest the calmest — both null when the day has too little data. |
data.data_available | false = we hold nothing for that date; every number above is then empty rather than zero. |
data.compare | Present only with compare=1: the same shape for the previous day plus delta_avg. |
curl "https://nakordoni.eu/api/v1/data/stats?ppid=id_15&date=2026-06-01&compare=1" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Hyni si zhvillues për ta provuar këtë endpoint drejtpërdrejt në Sandbox — 50 thirrje testimi falas në ditë. Hyni