Search foods by name

食事記録の利用者が入力する方法で食品を検索します。結果には2つのカタログが混在します。一般食品(「バナナ」「全乳」)は通常、食事記録の項目が指す食品です。もう一方はTuduuマスターカタログのパッケージ商品です。各結果には100 gあたりの主要栄養素と分量がすでに含まれているため、検索結果の表示に追加の呼び出しは必要ありません。 1ページは15項目で、サイズは設定できません。クエリが一致する場合、最初のページには最大5件の一般食品が表示されます。そのページの残りと、それ以降のすべてのページには、パッケージカタログの商品が表示されます。 次のページへ進むには、受け取った「meta.nextCursor」を返送します。「searchText」は不要です。カーソルにクエリがすでに含まれており、両方を送信した場合もカーソルが優先されます。「nextCursor」がnullなら、これ以上ありません。スクロールは最初の1000件のパッケージ商品で停止します。それより先に進むには、クエリを絞り込んでください。 照合では、アクセント記号、単数形・複数形、追加の修飾語が許容されます。「caffè zuccherato」では空のリストではなく、コーヒーが返されます。既知のカロリーがある食品のみが返されます。パッケージ商品は、食用カテゴリに属し、ブランドを明示している商品に限定されます。名前だけで説明された商品は重複商品と区別できないためです。このような商品もIDで引き続き指定できます。分量を明示するパッケージ商品が先に表示されます。 イタリア語のみ:一般食品名がイタリア語にしか存在しないため、Accept-Languageが他の言語の場合、このエンドポイントは406を返します。

POST
/foods/search
Foods
料金:20クレジット

リクエスト

application/json
object

FoodSearchRequest

object

searchText?

日記の利用者が入力するような、検索対象の食品名の自由記述。検索を開始するには必須です。「cursor」も送信した場合は無視されます

string | null

cursor?

前回の呼び出しで「meta.nextCursor」として返された不透明なトークン。そのページの次のページを取得するために使用します。クエリがすでに含まれているため、「searchText」は不要で、両方を送信した場合は無視されます。新しい検索を開始する場合はcursorを送信しないでください

string | null