Eatery Lunch API

Ett API för att hämta den aktuella lunchmenyn på SSIS.

Notera:

Vänligen notera att detta är ett helt inofficiellt API och drivs inte av Eatery eller någon som är associerad med de. Om du arbetar på Eatery och inte tycker om att denna hemsida körs, vänligen kontakta hemsidesadministratören.

Statistik

Förfrågningar senaste dagen: 79 st
Förfrågningar denna vecka: 1186 st
Förfrågningar denna månad: 5518 st
Totalt: 172213 st

Hur du interagerar med API:et

Endpoints

GET/api/ Hämta aktuell lunchmeny

Denna endpoint hämtar den aktuella lunchmenyn för Eatery Kista Nod för den nuvarande veckan (i svensk tidszon). Det är det enklaste och smidigaste sättet att hämta den aktuella menyn.

GET/api/{menu_id}/{week_number} Hämta meny för en efterfrågad vecka

Denna endpoint fungerar som Hämta aktuell lunchmeny-endpointen, men tillåter lite mer anpassning.

Parameter: menu_id

Eatery-restaurangen som menyn ska hämtas för. All Eaterys restaurang-ID:n kan hittas här (ID:na är toppnivånycklarna i JSON-svaret, till exempel "kista_nod"). Notera dock att endast följande menyer sparas på servern:

/kista-nod

Notera att denna parameter endast har ett möjligt värde då den endast sparar menyn på Eatery Kista Nod!

Notera:

31 maj 2022 (i källkoden), 19 september 2022 på det publika API:et så ändrades formatet för meny-ID:t för att primärt acceptera ett textbaserat ID som t.ex. "kista_nod". Detta på grund av att Eatery tenderar att ändra sitt meny-ID lite då och då, och genom att istället ha ID:t på detta sätt så kan API:et gå runt det problemet.
Du kan fortfarande använda meny-ID:t (till exempel 2401) för att komma åt menyer, men det rekommenderas inte ifall Eatery ändrar det. (så inga uppdateringar till dina skript om du inte orkar just nu, woo!)

Nyheter!

Från och med 21 september 2022 så sparas/"cachas" tidigare veckans menyer på servern. Detta innebär att du kan använda denna endpoint till att hämta tidigare menyer. Skulle en meny ändras under veckan så sparas även den tidigare menyn (innan ändringen) och görs tillgänglig under "previous_revisions" i API-svaret.

Tidigare år

För att arbeta med data från tidigare år kan du lägga till ?year= som en URL-parameter på slutet av din förfrågning. Som standard kommer endast data från det aktuella året att returneras, även när du listar menyer. Denna parameter finns tillgängliga på samtliga endpoints förutom den helautomatiska (/api) från och med 13 januari 2023.

Parameter: week_number

Veckonumret som du vill hämta menyn för.

GET/api/{menu_id}/{week_number}/{day_number} Hämta meny för en specifik dag

Denna endpoint kan användas för att hämta en meny för en specifik dag. Man får direkt upp menyn för just denna dag.

Parameter: menu_id

Eatery-restaurangen som menyn ska hämtas för. Se ovan för mer information samt en lista över giltiga parametrar.

Parameter: week_number

Veckonumret som menyn ska hämtas för. Nyhet 13 januari 2023: Skriv "now" for att få den aktuella veckan.

Parameter: day_number

Numret på den dag du vill hämta menyn för (måndag-söndag). Spannet på detta nummer är 1-7. Nyhet 13 januari 2023: Skriv "today" for att få den aktuella dagen. Notera att Eatery inte brukar servera mat under lördagar eller söndagar och därför kommer menyn oftast vara otillgänglig då!

GET/api/available_menus Hämta tillgängliga menyer

Hämtar en lista över alla menyer som finns tillgängliga och sparade på servern. Genom att använda de endpoints där man kan ange veckonumret kan man hämta de tidigare menyer som nämns här.

Förväntade svar

För menyrelaterade endpoints

Om den efterfrågade menyn finns på servern så borde du få ett svar i stil med detta:

{
	"menu": {
		"title": "Lunchmeny Eatery Kista Nod v.8",
		"week_number": 8,
		"days": {
			"monday": {
				"day_name": {
					"swedish": "Måndag",
					"english": "Monday"
				},
				"dishes": [
					"Thaigryta med bambuskott och ris",
					"Friterad spättafilé med tartarsås, dillslungad potatis och kålsallad med citronvinegrette",
					"Enchiladas med kryddig sojafärs, bönor, het tomatsås, och ris"
				],
				"special_features": {
					"sweet_tuesday": false,
					"fruity_wednesday": false,
					"pancake_thursday": false,
					"burger_friday": false
				}
			},
			"tuesday": {
				"day_name": {
					"swedish": "Tisdag",
					"english": "Tuesday"
				},
				"dishes": [
					"Husets spaghetti Carbonara med riven grana padano och svartpeppar",
					"Krämig torsk från medelhavet med smörig rödvinssås, och kokt potatis samt picklad rödlök",
					"Tortellini a la Panna med krämig parmesanost- & svartpepparsås"
				],
				"special_features": {
					"sweet_tuesday": false,
					"fruity_wednesday": false,
					"pancake_thursday": false,
					"burger_friday": false
				}
			},
			"wednesday": {
				"day_name": {
					"swedish": "Onsdag",
					"english": "Wednesday"
				},
				"dishes": [
					"Köttbullar med gräddsås, kokt potatis , lingon och inlagd grurka",
					"Wallenbergare på lax med rårörda lingon, sallad på gröna ärtor och fänkål och potatispuré",
					"Falafel med spenatbulgur, spetskål, citron och sambalcremé"
				],
				"special_features": {
					"sweet_tuesday": false,
					"fruity_wednesday": false,
					"pancake_thursday": false,
					"burger_friday": false
				}
			},
			"thursday": {
				"day_name": {
					"swedish": "Torsdag",
					"english": "Thursday"
				},
				"dishes": [
					"Kyckling gröncurry, kokos, limeblad, cashewnötter samt asiatiskt ris med cardemumma",
					"Bakad nilabborre med citronvelouté, rödbetspanko och knaperstekt bacon",
					"Majs och chilisoppa med rostade rotfrukter, örtolja, krispigt bröd",
					"Pancake Thursday: Vi bjuder på pannkakor, lättvispad grädde och hemmagjord sylt!"
				],
				"special_features": {
					"sweet_tuesday": false,
					"fruity_wednesday": false,
					"pancake_thursday": true,
					"burger_friday": false
				}
			},
			"friday": {
				"day_name": {
					"swedish": "Fredag",
					"english": "Friday"
				},
				"dishes": [
					"Ugnsbakad Falukorv med chilibearnaise, Idahopotatis och brynta bönor",
					"Fishtaco med mangosallad, citrusaioli, ris och tortillabröd",
					"Risotto med bakad hokaidoopumpa, ruccola och lagrad ost"
				],
				"special_features": {
					"sweet_tuesday": false,
					"fruity_wednesday": false,
					"pancake_thursday": false,
					"burger_friday": false
				}
			}
		},
		"footer": "Allergi? Fråga oss!\n   Rädda maten!\nOm vi får över mat från lunchen säljer vi matlådor mellan kl. 13.30-14.30 för take away.\nEndast 64kr, bra för miljön och för din plånbok."
	},
	"menu_id": 2401,
	"last_retrieved_at": 1677004673.557245,
	"previous_revisions": [{
		"revision_number": 1,
		"change_discovered_at": 1676882703.20626,
		"previous_data": {
			"title": "Lunchmeny Eatery Kista Nod v.8",
			"week_number": 8,
			"days": {
				"monday": {
					"day_name": {
						"swedish": "Måndag",
						"english": "Monday"
					},
					"dishes": [
						"Thaigryta med bambuskott och ris",
						"Friterad spättafilé med tartarsås, dillslungad potatis och kålsallad med citronvinegrette",
						"Enchiladas med kryddig sojafärs, bönor, het tomatsås, och ris"
					],
					"special_features": {
						"sweet_tuesday": false,
						"fruity_wednesday": false,
						"pancake_thursday": false,
						"burger_friday": false
					}
				},
				"tuesday": {
					"day_name": {
						"swedish": "Tisdag",
						"english": "Tuesday"
					},
					"dishes": [
						"Husets spaghetti Carbonara med riven grana padano och svartpeppar",
						"Krämig torsk från medelhavet med smörig rödvinssås, och kokt potatis samt picklad rödlök",
						"Tortellini a la Panna med krämig parmesanost- & svartpepparsås"
					],
					"special_features": {
						"sweet_tuesday": false,
						"fruity_wednesday": false,
						"pancake_thursday": false,
						"burger_friday": false
					}
				},
				"wednesday": {
					"day_name": {
						"swedish": "Onsdag",
						"english": "Wednesday"
					},
					"dishes": [
						" Köttbullar med gräddsås, kokt potatis , lingon och inlagd grurka",
						"Wallenbergare på lax med rårörda lingon, sallad på gröna ärtor och fänkål och potatispuré",
						"Falafel med spenatbulgur, spetskål, citron och sambalcremé"
					],
					"special_features": {
						"sweet_tuesday": false,
						"fruity_wednesday": false,
						"pancake_thursday": false,
						"burger_friday": false
					}
				},
				"thursday": {
					"day_name": {
						"swedish": "Torsdag",
						"english": "Thursday"
					},
					"dishes": [
						" Kyckling gröncurry, kokos, limeblad, cashewnötter samt asiatiskt ris med cardemumma",
						"Bakad nilabborre med citronvelouté, rödbetspanko och knaperstekt bacon",
						"Majs och chilisoppa med rostade rotfrukter, örtolja, krispigt bröd",
						"Pancake Thursday: Vi bjuder på pannkakor, lättvispad grädde och hemmagjord sylt!"
					],
					"special_features": {
						"sweet_tuesday": false,
						"fruity_wednesday": false,
						"pancake_thursday": true,
						"burger_friday": false
					}
				},
				"friday": {
					"day_name": {
						"swedish": "Fredag",
						"english": "Friday"
					},
					"dishes": [
						"Ugnsbakad Falukorv med chilibearnaise, Idahopotatis och brynta bönor",
						"Fishtaco med mangosallad, citrusaioli, ris och tortillabröd",
						"Risotto med bakad hokaidoopumpa, ruccola och lagrad ost"
					],
					"special_features": {
						"sweet_tuesday": false,
						"fruity_wednesday": false,
						"pancake_thursday": false,
						"burger_friday": false
					}
				}
			},
			"footer": "Allergi? Fråga oss!"
		}
	}],
	"status": "success",
	"status_code": 200
}

Om den efterfrågade menyn inte finns på servern så kommer du att få ett 404 Not Found-svar som säger vad som är fel.

För listan av menyer

Om parametrar till API:et är ogiltiga så kommer du få ett 400 Bad Request-svar.

Alla andra statuskoder är oväntade och kan indikera ett möjligt fel på servern.

För de felmeddelanden som är korrekt hanterade av servern så kommer du att få ett JSON-svar som berättar mer om vad som gick fel: