Search foods by name
按照饮食日记用户输入食物的方式搜索食物。结果混合来自两个目录的内容:通用食物(“香蕉”、“全脂牛奶”),这些通常就是日记条目所指的内容;以及 Tuduu 主目录中的包装商品。每个结果都已附带每 100 克的宏量营养素和份量,因此展示搜索结果无需再次调用接口。 每页包含 15 个项目,页面大小不可配置。当查询匹配到任意内容时,前 5 个通用食物最多会出现在第一页;第一页中其余的项目以及后续每一页的所有项目都来自包装商品目录。 要继续滚动,请回传你收到的“meta.nextCursor”,无需提供“searchText”:游标已经携带查询条件;如果两者都发送,游标优先。“nextCursor”为 null 表示没有更多结果。滚动会在前 1000 个包装商品后停止;如需查找更靠后的结果,请细化查询。 匹配会容忍重音符号、单复数和额外修饰词:“caffè zuccherato”会返回咖啡,而不是空列表。只返回已知热量的食物;包装商品结果仅限可食用类别以及声明了品牌的产品,因为仅由名称描述的产品无法与其重复项区分;这些产品仍可通过 id 访问。声明了份量的包装商品结果优先显示。 仅支持意大利语:对于任何其他 Accept-Language,此接口都会返回 406,因为通用食物名称仅提供意大利语。
请求
FoodSearchRequest
object
FoodSearchRequest
searchText?
用于搜索的自由文本食物名称,即日志用户会输入的名称。开始搜索时必需;同时发送“cursor”时会被忽略
cursor?
上一次调用以“meta.nextCursor”返回的不透明令牌,用于获取上一页之后的页面。它已包含查询,因此不需要“searchText”;两者同时发送时,“searchText”会被忽略。不发送 cursor 即可开始新的搜索