Search foods by name

Sök efter livsmedel på samma sätt som en användare av en matdagbok skriver dem. Resultaten kombinerar två kataloger: generiska livsmedel (”banan”, ”standardmjölk”), som en dagboksanteckning vanligtvis syftar på, och förpackade produkter från Tuduu-huvudkatalogen. Varje resultat innehåller redan dess makronäringsämnen per 100 g och dess portionsstorlek, så det behövs inget ytterligare anrop för att visa ett sökresultat. Sidorna innehåller 15 objekt och storleken kan inte konfigureras. Upp till 5 generiska livsmedel visas på den första sidan när frågan matchar något; allt därefter, både på den sidan och på alla senare sidor, kommer från katalogen över förpackade produkter. För att bläddra skickar du tillbaka ”meta.nextCursor” som du fick, utan att ange ”searchText”: markören innehåller redan frågan och har företräde om du skickar båda. En null-värde för ”nextCursor” betyder att det inte finns något mer. Bläddringen stoppas efter de första 1000 förpackade produkterna – förfina frågan för att nå längre. Matchningen tolererar accenter, singular och plural samt extra beskrivningar: ”caffè zuccherato” returnerar kaffe i stället för en tom lista. Endast livsmedel med kända kalorivärden returneras; förpackade resultat begränsas till ätbara kategorier och produkter som anger ett varumärke, eftersom en produkt som endast beskrivs med sitt namn inte kan skiljas från sina dubbletter – dessa produkter förblir åtkomliga via id. Förpackade resultat som anger en portion visas först. Endast italienska: denna endpoint svarar med 406 för alla andra värden för Accept-Language, eftersom generiska livsmedelsnamn endast finns på italienska.

POST
/foods/search
Foods
Kostnad: 20 krediter

Begäran

application/json
object

FoodSearchRequest

object

searchText?

Livsmedelsnamn i fritext att söka efter, så som en dagboksanvändare skulle skriva det. Krävs för att starta en sökning; ignoreras när ”cursor” också skickas

string | null

cursor?

Ogenomskinlig token som returnerades som ”meta.nextCursor” av ett tidigare anrop, för att hämta sidan efter den. Den innehåller redan frågan, så ”searchText” behövs inte och ignoreras när båda skickas. Skicka ingen cursor för att starta en ny sökning

string | null