Rajapinta

Jokaisessa vastauksessa on Access-Control-Allow-Origin: *, joten rajapintaa voi kutsua suoraan selaimesta. JSON-vastauksissa on aina kentät generated ja lang.

Reitit /api/day, /api/search ja /api/menus.csv palauttavat samanlaisia rivejä, joten yksi jäsennin riittää niille kaikille.

/api/menus

Koko viikko kaikilta ravintoloilta, jäsennettynä.

http://ruoka.luhte.de/api/menus?lang=fi kokeile

Vastaus { updated, lang, campusOrder, restaurants: [ { name, campus, url, lat, lon, cost, days: [ { key, day, label, hours, sections: [ { name, price, items: [ { name, tags, allergens } ] } ] } ] } ] }

/api/day

Yksi päivä litteinä riveinä. Helpoin kun haluat vain tämän päivän ruoat.

http://ruoka.luhte.de/api/day?pvm=2026-10-06&merkki=Veg kokeile

Vastaus { date, heading, rows: [ rivi ] }

/api/restaurant/{slug}

Yhden ravintolan koko viikko. Slugin saat reitistä /api/restaurants.

http://ruoka.luhte.de/api/restaurant/galilei kokeile

Vastaus { updated, restaurant } tai 404 jos slugia ei ole

/api/menus.csv

Samat rivit CSV-taulukkona. Avautuu suoraan taulukkolaskentaan.

http://ruoka.luhte.de/api/menus.csv?merkki=Veg kokeile

Vastaus CSV, otsikkorivi: date,day,hours,restaurant,slug,campus,section,price,dish,tags,allergens

/api/search

Annoshaku viikon listoilta. Kaikkien sanojen on osuttava, ääkköset eivät haittaa.

http://ruoka.luhte.de/api/search?haku=lohi&merkki=G kokeile

Vastaus { query, count, rows: [ rivi ] }

/api/dishes

Viikon eri annokset ja monessako ravintolassa kukin on.

http://ruoka.luhte.de/api/dishes?merkki=Veg kokeile

Vastaus { count, dishes: [ { dish, tags, count, restaurants } ] }

/api/tags

Käytössä olevat merkinnät ja niiden esiintymismäärät.

http://ruoka.luhte.de/api/tags kokeile

Vastaus { tags: [ { tag, count } ] }

/api/restaurants

Ravintolat, koordinaatit ja tunnisteet ilman ruokalistoja. Kevyt ja harvoin muuttuva.

http://ruoka.luhte.de/api/restaurants kokeile

Vastaus { updated, campusOrder, restaurants: [ { name, slug, campus, url, lat, lon, costNumber, days, stale, error } ] }

/api/open

Mitkä ravintolat ovat auki annettuna kellonaikana, ja montako minuuttia sulkemiseen.

http://ruoka.luhte.de/api/open?klo=12:30 kokeile

Vastaus { date, at, open: [...], closed: [...], unknown: [...] } jokainen { name, slug, hours, opensAt, closesAt, open, minutesLeft }

/api/nearest

Lähimmät ravintolat linnuntietä. Sodexon aukioloaikaa ei ole syötteessä, joten sen open on null.

http://ruoka.luhte.de/api/nearest?lat=60.4557&lon=22.2856&limit=3 kokeile

Vastaus { from, date, restaurants: [ { name, slug, lat, lon, meters, hours, open } ] }

/api/history

Milloin ja missä annosta on ollut tarjolla. Kertyy sitä mukaa kun palvelin hakee listoja.

http://ruoka.luhte.de/api/history?haku=lohikeitto kokeile

Vastaus { query, count, hits: [ { date, restaurant, dish, tags } ] }

/api/stats

Historian tilastot: yleisimmät annokset ja vegaanivaihtoehtojen osuus ravintoloittain.

Ei parametreja.

http://ruoka.luhte.de/api/stats kokeile

Vastaus { days, firstDay, lastDay, dishes, uniqueDishes, top: [...], restaurants: [...] }

/tanaan

Päivän lista pelkkänä tekstinä. Sopii terminaaliin ja skripteihin.

http://ruoka.luhte.de/tanaan?merkki=Veg kokeile

Vastaus text/plain

/rss

Viikon listat RSS-syötteenä, yksi kohta per päivä.

http://ruoka.luhte.de/rss?merkki=Veg kokeile

Vastaus application/rss+xml

/ical

Viikon listat kalenteritapahtumina. Aukioloaika tulee tapahtuman kestoksi jos se tiedetään.

http://ruoka.luhte.de/ical?ravintola=galilei kokeile

Vastaus text/calendar

/api

Rajapintojen luettelo koneluettavassa muodossa.

Ei parametreja.

http://ruoka.luhte.de/api kokeile

Vastaus { description, common, endpoints, sources }

/docs

Tämä dokumentaatio.

Ei parametreja.

http://ruoka.luhte.de/docs kokeile

Vastaus text/html

/docs.md

Sama dokumentaatio Markdownina, esimerkiksi repoon tallennettavaksi.

Ei parametreja.

http://ruoka.luhte.de/docs.md kokeile

Vastaus text/markdown

/api/health

Palvelimen tila: välimuistin ikä, onnistuneet ravintolat, seuraava taustapäivitys.

Ei parametreja.

http://ruoka.luhte.de/api/health kokeile

Vastaus { ok, uptimeSeconds, upstream, history, tiles, refreshAt, nextRefresh, languages }

/api/refresh

Vanhentaa välimuistin. Seuraava lataus hakee tuoreet listat.

Ei parametreja.

http://ruoka.luhte.de/api/refresh kokeile

Vastaus text/plain

/tiles/{z}/{x}/{y}.png

Karttalaatta, rajattu Turkuun ja välimuistitettu levylle.

Ei parametreja.

http://ruoka.luhte.de/tiles/13/4602/2358.png kokeile

Vastaus image/png, 404 rajauksen ulkopuolella