Search foods by name

Keress élelmiszerekre úgy, ahogyan egy étkezési napló felhasználója beírná őket. Az eredmények két katalógus elemeit vegyítik: az általános élelmiszereket („banán”, „teljes tej”), amelyekre egy naplóbejegyzés általában hivatkozik, valamint a Tuduu fő katalógusából származó csomagolt termékeket. Minden eredmény már tartalmazza a 100 g-ra vonatkozó makrotápanyagokat és az adagot, ezért a keresési eredmény megjelenítéséhez nincs szükség további hívásra. Az oldalak 15 elemet tartalmaznak, méretük nem konfigurálható. Legfeljebb 5 általános élelmiszer nyitja meg az első oldalt, ha a lekérdezés bármelyikhez illeszkedik; ezt követően azon az oldalon és minden későbbi oldalon minden elem a csomagolt katalógusból származik. A görgetéshez küldd vissza a kapott „meta.nextCursor” értéket, „searchText” nélkül: a kurzor már tartalmazza a lekérdezést, és elsőbbséget élvez, ha mindkettőt elküldöd. A null értékű „nextCursor” azt jelenti, hogy nincs több találat. A görgetés az első 1000 csomagolt termék után leáll — a további találatok eléréséhez pontosítsd a lekérdezést. A párosítás tolerálja az ékezeteket, az egyes és többes számot, valamint a további módosítókat: a „caffè zuccherato” például kávét ad vissza üres lista helyett. Csak ismert kalóriatartalmú élelmiszerek jelennek meg; a csomagolt találatok az ehető kategóriákra és azokra a termékekre korlátozódnak, amelyek márkát adnak meg, mivel az a termék, amelyet csak a neve ír le, nem különböztethető meg a duplikátumaitól — ezek a termékek továbbra is azonosító alapján érhetők el. Először azok a csomagolt találatok jelennek meg, amelyek adagot adnak meg. Csak olasz nyelven: ez a végpont 406-os választ ad minden más Accept-Language értékre, mert az általános élelmiszernevek kizárólag olaszul léteznek.

POST
/foods/search
Foods
Költség: 20 kredit

Kérés

application/json
object

FoodSearchRequest

object

searchText?

A keresendő élelmiszernév szabad szövegként, úgy, ahogy egy napló felhasználója beírná. A keresés megkezdéséhez kötelező; a rendszer figyelmen kívül hagyja, ha a „cursor” szintén meg van adva

string | null

cursor?

Egy korábbi hívás által „meta.nextCursor” néven visszaadott átlátszatlan token a következő oldal lekéréséhez. A lekérdezést már tartalmazza, ezért a „searchText” nem szükséges, és a rendszer figyelmen kívül hagyja, ha mindkettőt elküldöd. Új keresés indításához ne küldj cursort

string | null