配餐软件
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

246 lines
6.3 KiB

<h1>菜品部分</h1>
<h1>1. 查询菜品(根据名字模糊查询)</h1>
<blockquote>
<p>GET /api/dish</p>
</blockquote>
<h3>输入:</h3>
<pre><code class="text">pageSize=20 // 默认20, 全部非必填
pageNo=0 // 默认0, 从0开始
keyword=番茄鸡蛋汤 // 查询关键字
mark=汤类 // 标签 取值参照GET /api/basic/enum 接口中的 mark
poly=蒸 // 烹饪手法 取值参照GET /api/basic/enum 接口中的 poly
</code></pre>
<h3>输出:</h3>
<pre><code class="json">{
&quot;body&quot;: {
&quot;content&quot;: [
{
&quot;icon&quot;: &quot;112342343.jpg&quot;,
&quot;id&quot;: 2,
&quot;ingredient&quot;: [
{
&quot;isMain&quot;: true,
&quot;key&quot;: &quot;011101&quot;,
&quot;value&quot;: 500
}
],
&quot;marks&quot;: &quot;主食&quot;,
&quot;poly&quot;: &quot;&quot;,
&quot;modify&quot;: 1695277128000,
&quot;month&quot;: [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
1,
12
],
&quot;name&quot;: &quot;番茄炒鸡蛋&quot;,
&quot;vender&quot;: 4
}
],
&quot;number&quot;: 0,
&quot;size&quot;: 20,
&quot;totalElements&quot;: 2,
&quot;totalPages&quot;: 1
},
&quot;code&quot;: 200,
&quot;desc&quot;: &quot;成功&quot;,
&quot;success&quot;: true
}
</code></pre>
<h1>2. 查询菜品(根据ID精确查询)</h1>
<blockquote>
<p>GET /api/dish</p>
</blockquote>
<h3>输入:</h3>
<pre><code class="text">id=1
</code></pre>
<h3>输出:</h3>
<pre><code class="json">{
&quot;icon&quot;: &quot;data:image/png;base64,iVBORkJggg==&quot;,
&quot;id&quot;: 1,
&quot;ingredient&quot;: [
{
&quot;isMain&quot;: true,
&quot;key&quot;: &quot;011101&quot;,
&quot;value&quot;: 500
}
],
&quot;marks&quot;: &quot;汤类&quot;,
&quot;poly&quot;: &quot;&quot;,
&quot;month&quot;: [
1,
3,
5,
7,
9,
12
],
&quot;name&quot;: &quot;番茄鸡蛋汤&quot;,
&quot;vender&quot;: 1
}
</code></pre>
<h1>3. 根据名称模糊查询(用于食谱部分选择菜品)</h1>
<blockquote>
<p>GET /api/dish/select</p>
</blockquote>
<h3>输入:</h3>
<pre><code class="text">keyword=婆
</code></pre>
<h3>输出:</h3>
<pre><code class="json">{
&quot;body&quot;: [
{
&quot;id&quot;: 25,
&quot;ingredient&quot;: [
{
&quot;key&quot;: &quot;3355&quot;,
&quot;value&quot;: 22
},
{
&quot;key&quot;: &quot;3378&quot;,
&quot;value&quot;: 111
}
],
&quot;marks&quot;: &quot;面食&quot;,
&quot;poly&quot;: &quot;&quot;,
&quot;name&quot;: &quot;麻婆豆腐&quot;
},
{
&quot;id&quot;: 24,
&quot;ingredient&quot;: [
{
&quot;isMain&quot;: false,
&quot;key&quot;: &quot;3355&quot;,
&quot;value&quot;: 22
},
{
&quot;isMain&quot;: true,
&quot;key&quot;: &quot;3378&quot;,
&quot;value&quot;: 111
}
],
&quot;marks&quot;: &quot;面食&quot;,
&quot;poly&quot;: &quot;&quot;,
&quot;name&quot;: &quot;麻婆豆腐&quot;
}
],
&quot;code&quot;: 200,
&quot;desc&quot;: &quot;成功&quot;,
&quot;success&quot;: true
}
</code></pre>
<h1>4. 营养标签</h1>
<blockquote>
<p>GET /api/dish/label</p>
</blockquote>
<h3>输入:</h3>
<pre><code class="text">ids=1,2,3 // 传了ID返回指定标签,不传返回所有菜品的标签列表
</code></pre>
<h3>输出:</h3>
<pre><code class="json">{
&quot;body&quot;: [
{
&quot;component&quot;: [
{
&quot;name&quot;: &quot;&quot;,
&quot;nutrition&quot;: &quot;60.00(mg)&quot;,
&quot;nvr&quot;: &quot;0.00%&quot;
},
{
&quot;name&quot;: &quot;vitamin-a&quot;,
&quot;nutrition&quot;: &quot;115.00(-)&quot;,
&quot;nvr&quot;: &quot;-&quot;
},
{
&quot;name&quot;: &quot;蛋白质&quot;,
&quot;nutrition&quot;: &quot;75.00(g)&quot;,
&quot;nvr&quot;: &quot;1.00%&quot;
},
{
&quot;name&quot;: &quot;脂肪&quot;,
&quot;nutrition&quot;: &quot;50.00(g)&quot;,
&quot;nvr&quot;: &quot;1.00%&quot;
},
{
&quot;name&quot;: &quot;能量kcal&quot;,
&quot;nutrition&quot;: &quot;50.00(kcal)&quot;,
&quot;nvr&quot;: &quot;0.00%&quot;
}
],
&quot;ingredients&quot;: [
&quot;小麦&quot;
],
&quot;name&quot;: &quot;番茄炒鸡蛋&quot;
}
],
&quot;code&quot;: 200,
&quot;desc&quot;: &quot;成功&quot;,
&quot;success&quot;: true
}
</code></pre>
<h1>5. 添加菜品</h1>
<blockquote>
<p>PUT /api/dish</p>
</blockquote>
<h3>输入:</h3>
<pre><code class="text">Content-Type:application/x-www-form-urlencoded
name=番茄炒鸡蛋 // 必填 名称
vendors=1,2,3 // 单位列表, 管理端必填,业务端没用
icon= // 图片
month=1,2,3 //月份
mark=汤类 // 必填 标签 取值参照GET /api/basic/enum 接口中的 mark
poly=蒸 // 必填 烹饪手法 取值参照GET /api/basic/enum 接口中的 poly
ingredient=[{&quot;key&quot;: &quot;011101&quot;, &quot;value&quot;: 500, &quot;isMain&quot;: true}] // 食材列表
</code></pre>
<h3>输出:</h3>
<pre><code class="json">{
&quot;code&quot;: 200,
&quot;desc&quot;: &quot;成功&quot;,
&quot;success&quot;: true
}
</code></pre>
<h1>6. 修改</h1>
<blockquote>
<p>POST /api/dish</p>
</blockquote>
<h3>输入:</h3>
<pre><code class="text">Content-Type:application/x-www-form-urlencoded
id=1 // 必填
name=番茄炒鸡蛋 // 必填 名称
vendors=1,2,3 // 单位列表
icon= // 图片
month=1,2,3 // 月份
mark=汤类 // 标签 取值参照GET /api/basic/enum 接口中的 mark
poly=蒸 // 必填 烹饪手法 取值参照GET /api/basic/enum 接口中的 poly
ingredient=[{&quot;key&quot;: &quot;011101&quot;, &quot;value&quot;: 500, &quot;isMain&quot;: true}] // 食材列表
</code></pre>
<h3>输出:</h3>
<pre><code class="json">{
&quot;code&quot;: 200,
&quot;desc&quot;: &quot;成功&quot;,
&quot;success&quot;: true
}
</code></pre>
<h1>7. 删除</h1>
<blockquote>
<p>DELETE /api/dish</p>
</blockquote>
<h3>输入:</h3>
<p>Content-Type:application/x-www-form-urlencoded
ids=9,10 // 必填</p>
<p>输出:</p>
<pre><code class="text">{
&quot;code&quot;: 200,
&quot;desc&quot;: &quot;成功&quot;,
&quot;success&quot;: true
}
</code></pre>