Trimiterea știrilor și flota NakBus se află acum în panoul de partener
Conectați-vă contul de dezvoltator la un cont Nakordoni Partners cu același e-mail și gestionați acolo știrile și flota dvs. de autobuze (NakDriver / NakManager), cu roluri de echipă. Cheile API, punctele finale și aplicațiile dvs. rămân neschimbate, iar paginile de aici continuă să funcționeze. Deschide Nakordoni Partners

← Toate endpointurile

API „Cel mai bun moment de trecere" Online

Statistici săptămână tipică per punct de trecere: matrice 7×24 zi-săptămână×oră (mediană + bandă p25/p75), ziua cea mai liniștită/aglomerată, cele mai bune/proaste ferestre de 2 ore.

GET https://nakordoni.eu/api/v1/data/day-stats — clasă de cotă: cheap

ParametruDescriere
ppidID punct de trecere
langCod limbă

Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.

CâmpDescriere
data.matrix7×24 median queue: matrix[dayOfWeek][hour], day 0 = Monday, hours in the checkpoint's timezone (data.tz).
data.loSame 7×24 shape — the p25 floor of the band; hi is the p75 ceiling.
data.countsObservations behind each cell — a cell with few counts is a weak median.
data.weekday_avgSeven averages, one per weekday; best_day and worst_day index into them.
data.best_slots[]Quietest 2-hour windows: dow, hour, v (the value). worst_slots is the same for the busiest.
data.overall_avgAverage across the whole matrix, with overall_max.
data.samplesReadings the matrix was built from, over period_days; data_quality grades that sample.
data.data_quality'high' = the matrix is this checkpoint's OWN observations. 'low' = there was not enough direct history, so the mirror direction's matrix is returned as an estimate — see estimated_from.
data.estimated_fromPresent only when data_quality is low: the ppid the matrix actually came from (the same crossing in the opposite direction, same vehicle type). The numbers are NOT observations of the checkpoint you asked for — do not feed them to a model as if they were. data_quality_note carries the same warning as prose.
data.generated_atWhen the matrix was last recomputed (unix). It is precomputed daily, not per request.
curl "https://nakordoni.eu/api/v1/data/day-stats?ppid=id_13&lang=en" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Autentifică-te ca dezvoltator pentru a testa acest endpoint live în sandbox — 50 de apeluri de test gratuite pe zi. Autentificare

Actualizat