Lounastaja voidaan integroida infonäyttöihin kahdella eri tavalla, käyttäen Lounastajassa luotua kuvalinkkiä tai rajapintaa.
1. Kuvalinkin käyttäminen infonäytöissä
Lounastajassa voi luoda linkin kuvalle, jota voidaan käyttää infonäytöissä. Linkki ohjaa infonäyttökuvaan, johon päivitetään aina nykyisen viikon lounaslista. Sama linkki toimii jatkuvasti, eli se tarvitsee lisätä infonäyttöihin vain kerran. Infonäyttökuvan voi luoda Lounastajassa, ja siihen voi sisällyttää joko päivän lounaslistan tai koko viikon lounaslistan.
Näin löydät linkin kuvaa varten:
Saat linkin infonäyttökuvaan suoraan Lounastajasta menemällä sivupalkista:
Jakaminen -> Tulosteet ja somekuvat.
Tämän jälkeen klikkaa lisävalinnat auki halutun kuvan kolmesta pisteestä ja valitse ”Infonäyttökuvan tiedot”.
Yleensä ”Full HD JPG-kuva” on kuvista paras valinta näyttöön.
Tarkat speksit
Infonäyttökuvasta luodaan kolme eri versiota: Full HD JPG-kuva, 4K JPG-kuva sekä täysilaatuinen PNG-kuva. Suosittelemme JPG-kuvien käyttöä infonäytöissä, sillä ne ovat aina standardikokoisia.
Full HD JPG-kuva
/v1/image/lunchlist/jpg/:apiKey/current/:imageId
Esim. https://lounastaja.app/api/v1/image/luchlist/jpg/xxxx-xxxx-xxxx-xxxx/current/yyyy
Hakee nykyisen viikon infonäyttökuvan JPG-muodossa 1920×1080 resoluutiossa (1080×1920 jos pystykuva)
4K JPG-kuva
/v1/image/lunchlist/jpg-4k/:apiKey/current/:imageId
Esim. https://lounastaja.app/api/v1/image/luchlist/jpg-4k/xxxx-xxxx-xxxx-xxxx/current/yyyy
Hakee nykyisen viikon infonäyttökuvan JPG-muodossa 3840×2160 resoluutiossa (2160×3840 jos pystykuva)
PNG-kuva
/v1/image/lunchlist/png/:apiKey/current/:imageId
Esim. https://lounastaja.app/api/v1/image/luchlist/png/xxxx-xxxx-xxxx-xxxx/current/yyyy
Hakee nykyisen viikon infonäyttökuvan täysilaatuisessa PNG-muodossa ilman resoluutiorajoituksia
2. Rajapinnan käyttäminen infonäytöissä
Rajapinta mahdollistaa lounaslista-datan haun JSON tai RSS-muodossa, jolloin infonäyttöjen sisältö voidaan räätälöidä täysin omaan formaattiin. Lounaslista ladataan API-pisteestä toimipisteen uniikilla API-avaimella. Datan voi hakea rajapinnasta itselle sopivin aikavälein.
Rajapinta löytyy osoitteesta https://lounastaja.app/api/
Eri API-pisteitä lounaslistan hakuun on:
Nykyisen viikon lounaslista (JSON)
/v1/week/:apiKey/current
Esim. https://lounastaja.app/api/v1/week/xxxx-xxxx-xxxx-xxxx/current
Hakee nykyisen viikon lounaslistan JSON-muodossa, sisältäen lounaslistan eri kieliversiot.
Aktiivisen viikon lounaslista (JSON)
/v1/week/:apiKey/active
Esim. https://lounastaja.app/api/v1/week/xxxx-xxxx-xxxx-xxxx/active
Hakee nykyisen viikon lounaslistan JSON-muodossa, sisältäen lounaslistan eri kieliversiot. Aktiivinen viikko tarkoittaa nykyistä viikkoa, mutta se voi näyttää seuraavan viikon lounaslistan jo edellisenä viikonloppuna jos ravintola on niin määritellyt. Ravintola voi halutessaan valita, että seuraavan viikon lounaslista näkyy jo pe-la tai la-su yöstä eteenpäin.
Tietyn viikon lounaslista (JSON)
/v1/week/:apiKey/:year/:week
Esim. https://lounastaja.app/api/v1/week/xxxx-xxxx-xxxx-xxxx/2024/8
Hakee halutun viikon lounaslistan JSON-muodossa, sisältäen lounaslistan eri kieliversiot. Huomaa, että Lounastajasta voi hakea vain nykyisen, edellisen tai seuraavan viikon lounaslistan.
Nykyisen viikon lounaslista (RSS)
/v1/rss/week/:apiKey/current?language=:lang
Esim. https://lounastaja.app/api/v1/rss/week/xxxx-xxxx-xxxx-xxxx/current?language=fi
Hakee nykyisen viikon lounaslistan RSS-muodossa. Määrittele lounaslistan kieli lisäämällä parametri ”language”, jonka arvo on kieli ISO 639-1 -muotoinen kielitunnus (esim. fi, en, sv).
Aktiivisen viikon lounaslista (RSS)
/v1/rss/week/:apiKey/active?language=:lang
Esim. https://lounastaja.app/api/v1/rss/week/xxxx-xxxx-xxxx-xxxx/active?language=fi
Hakee nykyisen viikon lounaslistan RSS-muodossa. Aktiivinen viikko tarkoittaa nykyistä viikkoa, mutta se voi näyttää seuraavan viikon lounaslistan jo edellisenä viikonloppuna jos ravintola on niin määritellyt. Ravintola voi halutessaan valita, että seuraavan viikon lounaslista näkyy jo pe-la tai la-su yöstä eteenpäin. Määrittele lounaslistan kieli lisäämällä parametri ”language”, jonka arvo on kieli ISO 639-1 -muotoinen kielitunnus (esim. fi, en, sv).
Nykyisen päivän lounaslista (RSS)
/v1/rss/week/:apiKey/current?language=:lang&days=current
Esim. https://lounastaja.app/api/v1/rss/week/xxxx-xxxx-xxxx-xxxx/current?language=fi&days=current
Hakee nykyisen päivän lounaslistan RSS-muodossa. Määrittele lounaslistan kieli lisäämällä parametri language, jonka arvo on kieli ISO 639-1 -muotoinen kielitunnus (esim. fi, en, sv).
Tiettyjen viikonpäivien lounaslista (RSS)
/v1/rss/week/:apiKey/current?language=:lang&days=:days
Esim. https://lounastaja.app/api/v1/rss/week/xxxx-xxxx-xxxx-xxxx/current?language=fi&days=1,2,3,4,5
Hakee haluttujen viikonpäivien lounaslistan RSS-muodossa. Määrittele halutut viikonpäivät lisäämällä parametri days, jonka arvo on pilkuilla eroteltu lista viikonpäivien numeroista (0-6, 0 = sunnuntai, 1 = maanantai, 2 = tiistai jne.) Määrittele lounaslistan kieli lisäämällä parametri language, jonka arvo on kieli ISO 639-1 -muotoinen kielitunnus (esim. fi, en, sv).
Jos ravintola ei ole julkaissut lounaslistaa, rajapinta antaa 404-virhekoodin viestillä ”No published week available”.