跳到主要内容

参考

菜品字段

菜品字段

以下是菜品所有字段的完整参考。必填字段已标出。其他所有字段均为可选,但为了提供最佳顾客体验,建议填写。

字段 类型 必填 描述
name String 是 显示在菜单上的菜品名称。最多 200 个字符。
description String 否 对菜品的简短描述。提及主要食材和烹饪方式。建议两到三句话。
price Decimal 是 显示价格(例如 14.99)。在菜单上向顾客展示。
priceCents Integer 自动 以分为单位存储的价格(例如 1499)。根据 price 字段自动计算。在内部使用以保证精度。
category String 否 该菜品所属的分类(例如"开胃菜"、"主菜"、"甜点")。用于在公开菜单上对菜品进行分组。
photoUrl URL 是 已上传照片的 URL。在上传和 AI 处理完成后自动设置。
isActive Boolean 否 该菜品是否在公开菜单上可见。默认为 true。设置为 false 可隐藏而不删除。
position Integer 否 在该菜品所属分类中的排序顺序。数字越小越靠前。没有位置值的菜品按创建日期排序。
restaurantId UUID 自动 该菜品所属的餐厅。根据您的会话自动设置。
createdAt DateTime 自动 菜品的创建时间戳。自动设置。
updatedAt DateTime 自动 最后一次更新的时间戳。每次保存时自动更新。

3D 模型字段(仅限 3D Menu Pro)

使用 3D Menu Pro 时,每个菜品可能关联一个 3D 模型,并具有以下附加字段:

字段 类型 描述
modelUrl URL 优化后的 GLB 模型文件的 URL。在处理完成后设置。
status Enum 处理状态:PENDING、GENERATING、PROCESSING、READY 或 FAILED。
provider String 用于 3D 生成的 AI 提供商。
providerTaskId String 来自 3D 生成提供商的外部任务 ID。用于状态轮询。