2161 lines
52 KiB
Markdown
2161 lines
52 KiB
Markdown
# 菜谱 API 接口文档
|
||
|
||
> **版本**: v2.0.0
|
||
> **更新日期**: 2026-04-10
|
||
> **基础地址**: `http://eat.wktyl.com/api/`
|
||
|
||
---
|
||
|
||
|
||
---
|
||
|
||
## 📁 接口文件说明
|
||
|
||
| 文件 | 说明 | 主要功能 |
|
||
|------|------|---------|
|
||
| `api.php` | 主接口 | 列表、详情、搜索、统计、统一输出 |
|
||
| `api_action.php` | 动态接口 | 点赞、推荐、浏览量 |
|
||
| `api_what_to_eat.php` | 智能选择 | 随机推荐、动态筛选 |
|
||
| `api_feed.php` | 信息流 | 推荐、热门、个性化 |
|
||
| `stats_full.php` | 全面统计 | 热门、在线、请求统计 |
|
||
| `api_preference.php` | 用户偏好 | 标签、分类、过敏原设置 |
|
||
| `api_check_duplicate.php` | 查重接口 | 菜品、食材、营养成分、内容查重 |
|
||
| `cache.php` | 缓存系统 | 工具类 |
|
||
| `cache_manage.php` | 缓存管理 | 运维工具 |
|
||
| `response.php` | 响应格式 | 工具类 |
|
||
|
||
---
|
||
|
||
## 目录
|
||
|
||
- [快速开始](#快速开始)
|
||
- [响应格式](#响应格式)
|
||
- [主接口 api.php](#主接口-apiphp)
|
||
- [动态接口 api_action.php](#动态接口-api_actionphp)
|
||
- [智能选择 api_what_to_eat.php](#智能选择-api_what_to_eatphp)
|
||
- [信息流 api_feed.php](#信息流-api_feedphp)
|
||
- [全面统计 stats_full.php](#全面统计-stats_fullphp)
|
||
- [用户偏好 api_preference.php](#用户偏好-api_preferencephp)
|
||
- [查重接口 api_check_duplicate.php](#查重接口-api_check_duplicatephp)
|
||
- [功能扩展指南](#功能扩展指南)
|
||
- [错误处理](#错误处理)
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
### 请求方式
|
||
|
||
支持 `GET` 和 `POST` 两种方式：
|
||
|
||
```
|
||
GET api.php?act=list&page=1
|
||
|
||
POST api.php
|
||
Content-Type: application/json
|
||
{"act": "list", "page": 1}
|
||
```
|
||
|
||
---
|
||
|
||
## 响应格式
|
||
|
||
### 支持格式
|
||
|
||
| 格式 | 参数 | 大小节省 | 推荐场景 |
|
||
|------|------|---------|---------|
|
||
| JSON | `_format=json` | 基准 | 调试开发 |
|
||
| Gzip | `_format=gzip` | 75%+ | 移动网络 |
|
||
| MessagePack | `_format=msgpack` | 35% | 高速网络 |
|
||
|
||
### 响应结构
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": { ... },
|
||
"_cached": false,
|
||
"_query_time": "15.23ms"
|
||
}
|
||
```
|
||
|
||
### 缓存控制
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| `_refresh=1` | 强制刷新缓存 |
|
||
| `_stale=1` | 允许返回过期缓存 |
|
||
| `_pretty=1` | 格式化JSON输出 |
|
||
|
||
---
|
||
|
||
## 主接口 api.php
|
||
|
||
### 📋 菜谱列表
|
||
|
||
```
|
||
GET api.php?act=list&page=1&limit=20&cate_id=11&search=鸡蛋
|
||
```
|
||
|
||
**功能**: 获取菜谱列表，支持分页、分类筛选、标签筛选、关键词搜索
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| page | int | 页码，默认1 |
|
||
| limit | int | 每页数量，默认20，最大100 |
|
||
| cate_id | int | 分类ID筛选 |
|
||
| tag_id | int | 标签ID筛选 |
|
||
| search | string | 搜索关键词 |
|
||
| use_preference | string | 设为"true"时应用用户偏好 |
|
||
| user_id | string | 用户ID（配合use_preference使用） |
|
||
|
||
**返回字段及功能扩展**:
|
||
|
||
| 字段 | 说明 | 可扩展功能 |
|
||
|------|------|-----------|
|
||
| `id` | 菜谱唯一ID | 用于详情查询、收藏、分享链接 |
|
||
| `title` | 菜谱标题 | 用于搜索、列表展示、分享标题 |
|
||
| `intro` | 菜谱简介 | 用于列表预览、搜索结果摘要 |
|
||
| `category_id` | 分类ID | 用于分类筛选、面包屑导航 |
|
||
| `category_name` | 分类名称 | 用于分类展示、筛选标签 |
|
||
| `tags` | 标签数组 | 用于标签云、相关推荐、口味筛选 |
|
||
| `view_count` | 浏览量 | 用于热门排序、趋势分析 |
|
||
| `comment_count` | 评论数 | 用于互动排序、热门判断 |
|
||
| `cover` | 封面图 | 用于列表展示、分享缩略图 |
|
||
| `create_time` | 创建时间 | 用于最新排序、时间线展示 |
|
||
|
||
---
|
||
|
||
### 📄 菜谱详情
|
||
|
||
```
|
||
GET api.php?act=detail&id=32892&viewnums=true
|
||
```
|
||
|
||
**功能**: 获取单个菜谱的基本信息
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| id | int | 菜谱ID（必填） |
|
||
| viewnums | string | 设为"true"时增加浏览量 |
|
||
|
||
**返回字段及功能扩展**:
|
||
|
||
| 字段 | 说明 | 可扩展功能 |
|
||
|------|------|-----------|
|
||
| `content` | 菜谱内容（HTML） | 用于详情页展示、步骤解析 |
|
||
| `ingredients` | 食材列表 | 用于购物清单、营养计算 |
|
||
| `meta` | 扩展属性 | 用于特殊功能（烹饪时间、难度等） |
|
||
| `author` | 作者信息 | 用于作者主页、贡献者展示 |
|
||
|
||
---
|
||
|
||
### 📖 菜谱完整信息
|
||
|
||
```
|
||
GET api.php?act=full&id=32892
|
||
```
|
||
|
||
**功能**: 获取菜谱的完整信息，包括所有关联数据
|
||
|
||
**返回字段及功能扩展**:
|
||
|
||
| 字段 | 说明 | 可扩展功能 |
|
||
|------|------|-----------|
|
||
| `code` | 菜谱编码（如CP032892） | 用于唯一标识、二维码生成、分享码 |
|
||
| `pic_id` | 原始图片ID| 用于新旧系统图片资源关联、图片迁移 |
|
||
| `category.hierarchy` | 分类层级（最多3级） | 用于面包屑导航、分类树展示 |
|
||
| `ingredients.main` | 主料列表 | 用于购物清单、主料筛选 |
|
||
| `ingredients.auxiliary` | 辅料列表 | 用于购物清单、辅料筛选 |
|
||
| `ingredients.seasoning` | 调料列表 | 用于购物清单、调料筛选 |
|
||
| `ingredients[].detail.allergen` | 食材过敏原 | 用于过敏提醒、健康警示 |
|
||
| `ingredients[].detail.nutrition` | 食材营养信息 | 用于营养计算、健康分析 |
|
||
| `ingredients[].detail.usage_tip` | 使用技巧 | 用于烹饪提示、新手指导 |
|
||
| `allergens` | 过敏原汇总 | 用于过敏原警示、用户过滤 |
|
||
| `nutrition` | 营养数据数组 | 用于营养分析、健康报告 |
|
||
| `statistics.view_count` | 浏览量 | 用于热门排序、趋势分析 |
|
||
| `statistics.like_count` | 点赞数 | 用于推荐排序、用户喜好分析 |
|
||
| `statistics.recommend_count` | 推荐数 | 用于推荐排序、质量评估 |
|
||
| `meta.process` | 烹饪工艺 | 用于工艺筛选（炒、蒸、煮等） |
|
||
| `meta.taste` | 口味特征 | 用于口味筛选（酸甜苦辣咸） |
|
||
| `meta.difficulty` | 难度等级 | 用于难度筛选、新手推荐 |
|
||
| `meta.time` | 烹饪时间 | 用于时间筛选、快速菜谱 |
|
||
|
||
---
|
||
|
||
### 🥗 食材列表
|
||
|
||
```
|
||
GET api.php?act=ingredients&page=1&search=鸡蛋
|
||
```
|
||
|
||
**功能**: 获取食材列表
|
||
|
||
**返回字段及功能扩展**:
|
||
|
||
| 字段 | 说明 | 可扩展功能 |
|
||
|------|------|-----------|
|
||
| `ingredient_id` | 食材ID | 用于详情查询、关联菜谱 |
|
||
| `name` | 食材名称 | 用于搜索、分类展示 |
|
||
| `allergen` | 过敏原标识 | 用于过敏提醒、健康过滤 |
|
||
| `allergen_type` | 过敏原类型 | 用于过敏原分类、用户设置 |
|
||
|
||
---
|
||
|
||
### 🥕 食材详情
|
||
|
||
```
|
||
GET api.php?act=ingredient_detail&id=1
|
||
```
|
||
|
||
**功能**: 获取单个食材的详细信息
|
||
|
||
**返回字段及功能扩展**:
|
||
|
||
| 字段 | 说明 | 可扩展功能 |
|
||
|------|------|-----------|
|
||
| `introduction` | 食材介绍 | 用于食材详情页、知识科普 |
|
||
| `nutrition` | 营养成分 | 用于营养分析、健康报告 |
|
||
| `usage_tip` | 使用技巧 | 用于烹饪提示、新手指导 |
|
||
| `effect` | 食疗功效 | 用于养生推荐、健康指导 |
|
||
| `guidance` | 选购指南 | 用于购物指导、品质判断 |
|
||
|
||
---
|
||
|
||
### 🔍 搜索
|
||
|
||
```
|
||
GET api.php?act=search&keyword=鸡蛋&type=recipe
|
||
```
|
||
|
||
**功能**: 全局搜索，支持食谱和食材
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| keyword | 搜索关键词 |
|
||
| type | 搜索类型：all/recipe/ingredient |
|
||
|
||
**功能扩展**:
|
||
- 支持模糊搜索，可用于智能搜索建议
|
||
- 搜索结果可按相关度、时间、热度排序
|
||
- 可用于搜索历史记录、热门搜索
|
||
|
||
---
|
||
|
||
### 📂 分类列表
|
||
|
||
```
|
||
GET api.php?act=categories&type=recipe
|
||
```
|
||
|
||
**功能**: 获取分类列表
|
||
|
||
**返回字段及功能扩展**:
|
||
|
||
| 字段 | 说明 | 可扩展功能 |
|
||
|------|------|-----------|
|
||
| `cate_ID` | 分类ID | 用于分类筛选 |
|
||
| `cate_Name` | 分类名称 | 用于分类展示 |
|
||
| `cate_ParentID` | 父分类ID | 用于分类树构建 |
|
||
| `cate_Count` | 分类下数量 | 用于热门分类排序 |
|
||
|
||
---
|
||
|
||
### 🏷️ 标签列表
|
||
|
||
```
|
||
GET api.php?act=tags&limit=50
|
||
```
|
||
|
||
**功能**: 获取标签列表
|
||
|
||
**功能扩展**:
|
||
- 可用于标签云展示
|
||
- 可用于口味筛选（酸甜苦辣咸）
|
||
- 可用于标签热度排行
|
||
|
||
---
|
||
|
||
### 📊 基础统计
|
||
|
||
```
|
||
GET api.php?act=stats
|
||
```
|
||
|
||
**功能**: 获取基础统计数据
|
||
|
||
**功能扩展**:
|
||
- 可用于首页数据展示
|
||
- 可用于运营分析报表
|
||
- 可用于数据大屏展示
|
||
|
||
---
|
||
|
||
### 🔎 高级查询
|
||
|
||
```
|
||
GET api.php?act=query&module=recipe&field=log_Title&value=鸡蛋&operator=like
|
||
```
|
||
|
||
**功能**: 高级数据库查询
|
||
|
||
| 操作符 | 说明 |
|
||
|--------|------|
|
||
| eq | 等于 |
|
||
| neq | 不等于 |
|
||
| like | 模糊匹配 |
|
||
| gt | 大于 |
|
||
| lt | 小于 |
|
||
| gte | 大于等于 |
|
||
| lte | 小于等于 |
|
||
|
||
**功能扩展**:
|
||
- 可用于自定义筛选条件
|
||
- 可用于数据分析导出
|
||
- 可用于后台管理查询
|
||
|
||
---
|
||
|
||
### 📦 统一格式输出（原 api_unified.php）
|
||
|
||
提供食谱和食材的一致性输出格式，方便App统一处理。
|
||
|
||
#### 统一列表
|
||
|
||
```
|
||
GET api.php?act=unified_list&type=recipe&page=1
|
||
GET api.php?act=unified_list&type=ingredient&page=1
|
||
```
|
||
|
||
**功能**: 获取统一格式的列表数据
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| type | 类型：recipe（食谱）/ ingredient（食材） |
|
||
| page | 页码 |
|
||
| limit | 每页数量 |
|
||
| cate_id | 分类筛选 |
|
||
| search | 搜索关键词 |
|
||
|
||
#### 统一详情
|
||
|
||
```
|
||
GET api.php?act=unified_detail&type=recipe&id=1
|
||
GET api.php?act=unified_detail&type=ingredient&id=1
|
||
```
|
||
|
||
**功能**: 获取统一格式的详情数据
|
||
|
||
#### 统一搜索
|
||
|
||
```
|
||
GET api.php?act=unified_search&type=recipe&keyword=鸡蛋
|
||
```
|
||
|
||
**功能**: 统一格式的搜索
|
||
|
||
#### 统一热门
|
||
|
||
```
|
||
GET api.php?act=unified_hot&type=recipe&limit=20
|
||
```
|
||
|
||
**功能**: 获取热门列表
|
||
|
||
#### 统一字段结构
|
||
|
||
```json
|
||
{
|
||
"id": 123,
|
||
"type": "recipe",
|
||
"type_name": "食谱",
|
||
"title": "菜谱名称",
|
||
"intro": "简介...",
|
||
"category": {"id": 11, "name": "家常菜"},
|
||
"statistics": {
|
||
"view_count": 1000,
|
||
"like_count": 50,
|
||
"recommend_count": 30
|
||
},
|
||
"publish_time": 1712500000,
|
||
"url": "?act=unified_detail&type=recipe&id=123"
|
||
}
|
||
```
|
||
|
||
**统一格式优势**:
|
||
- 🔄 食谱和食材使用相同结构，减少App端代码量
|
||
- 📱 适合移动端列表展示，字段精简
|
||
- 🔗 统一的URL格式，方便跳转
|
||
- 📊 统一的统计字段，方便排序和展示
|
||
|
||
---
|
||
|
||
## 动态接口 api_action.php
|
||
|
||
### 👍 点赞
|
||
|
||
```
|
||
GET api_action.php?act=like&type=recipe&id=1&action=like
|
||
```
|
||
|
||
**功能**: 点赞/取消点赞
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| type | 类型：recipe/ingredient |
|
||
| id | ID |
|
||
| action | 操作：like/unlike |
|
||
|
||
**功能扩展**:
|
||
- 可用于用户收藏功能
|
||
- 可用于点赞动画效果
|
||
- 可用于社交分享展示点赞数
|
||
|
||
---
|
||
|
||
### ⭐ 推荐
|
||
|
||
```
|
||
GET api_action.php?act=recommend&type=recipe&id=1&action=recommend&score=5
|
||
```
|
||
|
||
**功能**: 推荐/取消推荐
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| score | 推荐分数，范围0-5 |
|
||
|
||
**功能扩展**:
|
||
- 可用于五星评分系统
|
||
- 可用于推荐算法权重
|
||
- 可用于用户评价展示
|
||
|
||
---
|
||
|
||
### 👁️ 增加浏览量
|
||
|
||
```
|
||
GET api_action.php?act=view&type=recipe&id=1&count=1
|
||
```
|
||
|
||
**功能**: 增加浏览量
|
||
|
||
**功能扩展**:
|
||
- 可用于热门排行统计
|
||
- 可用于用户浏览历史
|
||
- 可用于趋势分析
|
||
|
||
---
|
||
|
||
## 智能选择 api_what_to_eat.php
|
||
|
||
### 🪜 获取筛选步骤
|
||
|
||
```
|
||
GET api_what_to_eat.php?act=filter_steps&category=13
|
||
```
|
||
|
||
**功能**: 获取当前可用的筛选选项和菜谱数量，实现逐步筛选
|
||
|
||
**返回字段及功能扩展**:
|
||
|
||
| 字段 | 说明 | 可扩展功能 |
|
||
|------|------|-----------|
|
||
| `steps[].name` | 步骤名称 | 用于筛选流程展示 |
|
||
| `steps[].options` | 可选项列表 | 用于筛选选项展示 |
|
||
| `steps[].matched_count` | 匹配数量 | 用于实时显示筛选结果数 |
|
||
|
||
**功能扩展**:
|
||
- 可用于"今天吃什么"决策流程
|
||
- 可用于智能推荐引导
|
||
- 可用于用户偏好学习
|
||
|
||
---
|
||
|
||
### ✅ 应用筛选
|
||
|
||
```
|
||
GET api_what_to_eat.php?act=filter_apply&category=13&tag=2&count=5
|
||
```
|
||
|
||
**功能**: 应用筛选条件，返回随机菜谱
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| category | 分类ID，多个用逗号分隔 |
|
||
| tag | 标签ID，多个用逗号分隔 |
|
||
| count | 返回数量，默认5，最大20 |
|
||
|
||
**功能扩展**:
|
||
- 可用于随机推荐功能
|
||
- 可用于"换一批"功能
|
||
- 可用于A/B测试推荐
|
||
|
||
---
|
||
|
||
### 📄 菜谱详情
|
||
|
||
```
|
||
GET api_what_to_eat.php?act=detail&id=32892
|
||
GET api_what_to_eat.php?act=detail&code=CP032892
|
||
GET api_what_to_eat.php?act=detail&title=鸡丁&fuzzy=1
|
||
```
|
||
|
||
**功能**: 多种方式查询菜谱详情
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| id | 菜谱ID |
|
||
| code | 菜谱编码（如CP032892） |
|
||
| title | 菜谱标题 |
|
||
| fuzzy | 是否模糊匹配，1=是 |
|
||
|
||
**返回字段及功能扩展**:
|
||
|
||
| 字段 | 说明 | 可扩展功能 |
|
||
|------|------|-----------|
|
||
| `id` | 菜谱唯一ID | 用于详情查询、收藏、分享链接 |
|
||
| `code` | 菜谱编码（如CP032892） | 用于二维码分享、唯一标识 |
|
||
| `pic_id` | 原始图片ID（来自zbp_recipe_id_map表） | 用于新旧系统图片资源关联、图片迁移 |
|
||
| `title` | 菜谱标题 | 用于搜索、列表展示、分享标题 |
|
||
|
||
**功能扩展**:
|
||
- `code` 可用于二维码分享、唯一标识
|
||
- `title+fuzzy` 可用于智能搜索、语音搜索
|
||
- `pic_id` 可用于关联旧系统图片资源
|
||
|
||
---
|
||
|
||
### 🎲 随机推荐
|
||
|
||
```
|
||
GET api_what_to_eat.php?act=random
|
||
```
|
||
|
||
**功能**: 随机推荐一个菜谱
|
||
|
||
**功能扩展**:
|
||
- 可用于"摇一摇"推荐
|
||
- 可用于每日推荐
|
||
- 可用于发现功能
|
||
|
||
---
|
||
|
||
### 🧠 智能推荐
|
||
|
||
```
|
||
GET api_what_to_eat.php?act=smart&include_categories=12,13&exclude_allergens=seafood
|
||
```
|
||
|
||
**功能**: 基于条件智能推荐
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| include_categories | 包含的分类ID |
|
||
| exclude_allergens | 排除的过敏原类型 |
|
||
|
||
**功能扩展**:
|
||
- 可用于个性化推荐
|
||
- 可用于过敏原过滤
|
||
- 可用于用户偏好推荐
|
||
|
||
---
|
||
|
||
## 信息流 api_feed.php
|
||
|
||
### 🔥 推荐信息流
|
||
|
||
```
|
||
GET api_feed.php?act=recommend&page=1&limit=20
|
||
```
|
||
|
||
**功能**: 混合推荐算法：热门40% + 最新40% + 随机20%
|
||
|
||
**返回字段及功能扩展**:
|
||
|
||
| 字段 | 说明 | 可扩展功能 |
|
||
|------|------|-----------|
|
||
| `id` | 菜谱唯一ID | 用于详情查询、收藏、分享链接 |
|
||
| `pic_id` | 原始图片ID| 用于新旧系统图片资源关联、图片迁移 |
|
||
| `title` | 菜谱标题 | 用于搜索、列表展示、分享标题 |
|
||
| `intro` | 菜谱简介 | 用于列表预览、搜索结果摘要 |
|
||
|
||
**功能扩展**:
|
||
- 可用于首页信息流
|
||
- 可用于下拉刷新加载
|
||
- 可用于无限滚动加载
|
||
- `pic_id` 可用于关联旧系统图片资源
|
||
|
||
---
|
||
|
||
### 📈 热门信息流
|
||
|
||
```
|
||
GET api_feed.php?act=hot&page=1&limit=20
|
||
```
|
||
|
||
**功能**: 按浏览量排序
|
||
|
||
**功能扩展**:
|
||
- 可用于热门榜单
|
||
- 可用于趋势分析
|
||
- 可用于爆款推荐
|
||
|
||
---
|
||
|
||
### 🆕 最新信息流
|
||
|
||
```
|
||
GET api_feed.php?act=latest&page=1&limit=20
|
||
```
|
||
|
||
**功能**: 按发布时间排序
|
||
|
||
**功能扩展**:
|
||
- 可用于最新发布
|
||
- 可用于时间线展示
|
||
- 可用于更新提醒
|
||
|
||
---
|
||
|
||
### 👤 个性化信息流
|
||
|
||
```
|
||
GET api_feed.php?act=personal&user_id=xxx
|
||
```
|
||
|
||
**功能**: 基于用户偏好推荐，自动应用偏好分类、偏好标签、屏蔽过敏原
|
||
|
||
**功能扩展**:
|
||
- 可用于个性化首页
|
||
- 可用于用户画像推荐
|
||
- 可用于千人千面
|
||
|
||
---
|
||
|
||
### ⚡ 预加载
|
||
|
||
```
|
||
GET api_feed.php?act=prefetch&pages=3&limit=20
|
||
```
|
||
|
||
**功能**: 一次性加载多页数据
|
||
|
||
**功能扩展**:
|
||
- 可用于离线缓存
|
||
- 可用于预加载优化
|
||
- 可用于减少请求次数
|
||
|
||
---
|
||
|
||
## 全面统计 stats_full.php
|
||
|
||
### 📊 全面统计
|
||
|
||
```
|
||
GET stats_full.php?act=stats&layer=basic
|
||
```
|
||
|
||
**功能**: 获取全面统计数据
|
||
|
||
| 层级 | 说明 |
|
||
|------|------|
|
||
| basic | 基础统计 |
|
||
| detail | 详细统计 |
|
||
| full | 完整统计 |
|
||
|
||
**功能扩展**:
|
||
- 可用于数据大屏
|
||
- 可用于运营报表
|
||
- 可用于后台管理
|
||
|
||
---
|
||
|
||
### 🔥 热门统计
|
||
|
||
```
|
||
GET stats_full.php?act=hot&period=today
|
||
GET stats_full.php?act=hot&period=month
|
||
GET stats_full.php?act=hot&period=total
|
||
```
|
||
|
||
**功能**: 获取热门排行榜
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| period | 时间范围：today/month/total |
|
||
| limit | 返回数量，默认20 |
|
||
|
||
**返回字段及功能扩展**:
|
||
|
||
| 字段 | 说明 | 可扩展功能 |
|
||
|------|------|-----------|
|
||
| `recipe_view` | 浏览量排行 | 用于热门榜单、趋势分析 |
|
||
| `recipe_like` | 点赞量排行 | 用于用户喜好分析、推荐权重 |
|
||
| `ingredient_view` | 食材浏览排行 | 用于热门食材、采购建议 |
|
||
|
||
---
|
||
|
||
### 👥 在线统计（原 api_online.php）
|
||
|
||
```
|
||
GET stats_full.php?act=online
|
||
```
|
||
|
||
**功能**: 获取在线用户统计
|
||
|
||
**返回字段及功能扩展**:
|
||
|
||
| 字段 | 说明 | 可扩展功能 |
|
||
|------|------|-----------|
|
||
| `online_total` | 在线总人数 | 用于实时在线展示 |
|
||
| `online_10min` | 10分钟内活跃 | 用于活跃度分析 |
|
||
| `online_1hour` | 1小时内活跃 | 用于用户粘性分析 |
|
||
| `platforms` | 平台分布 | 用于多平台分析 |
|
||
| `pages` | 页面分布 | 用于热门页面分析 |
|
||
|
||
---
|
||
|
||
### 💓 心跳更新
|
||
|
||
```
|
||
GET stats_full.php?act=heartbeat&platform=ios&page=home
|
||
```
|
||
|
||
**功能**: 更新用户在线状态
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| platform | 平台：web/ios/android/wechat/miniprogram |
|
||
| page | 当前页面 |
|
||
| data_type | 数据类型 |
|
||
| data_id | 数据ID |
|
||
|
||
**功能扩展**:
|
||
- 可用于实时在线展示
|
||
- 可用于用户行为追踪
|
||
- 可用于页面热度分析
|
||
|
||
---
|
||
|
||
### 📈 请求统计（原 api_request_stats.php）
|
||
|
||
```
|
||
GET stats_full.php?act=request
|
||
```
|
||
|
||
**功能**: 获取API请求统计
|
||
|
||
**返回字段及功能扩展**:
|
||
|
||
| 字段 | 说明 | 可扩展功能 |
|
||
|------|------|-----------|
|
||
| `total` | 总请求数 | 用于服务监控 |
|
||
| `today` | 今日请求数 | 用于日活分析 |
|
||
| `last_hour` | 最近1小时请求 | 用于实时监控 |
|
||
| `avg_daily` | 日均请求数 | 用于容量规划 |
|
||
| `apis` | 各接口调用统计 | 用于接口优化 |
|
||
|
||
---
|
||
|
||
## 用户偏好 api_preference.php
|
||
|
||
### 📋 获取偏好
|
||
|
||
```
|
||
GET api_preference.php?act=get&user_id=xxx
|
||
```
|
||
|
||
**功能**: 获取用户偏好设置
|
||
|
||
**返回字段及功能扩展**:
|
||
|
||
| 字段 | 说明 | 可扩展功能 |
|
||
|------|------|-----------|
|
||
| `preferred_tags` | 偏好标签 | 用于个性化推荐 |
|
||
| `preferred_categories` | 偏好分类 | 用于首页定制 |
|
||
| `blocked_allergens` | 屏蔽过敏原 | 用于健康过滤 |
|
||
|
||
---
|
||
|
||
### 💾 保存偏好
|
||
|
||
```
|
||
POST api_preference.php?act=save
|
||
{
|
||
"user_id": "xxx",
|
||
"preferred_tags": [1, 2, 3],
|
||
"preferred_categories": [11, 12],
|
||
"blocked_allergens": ["seafood", "nuts"]
|
||
}
|
||
```
|
||
|
||
**功能**: 保存用户偏好设置
|
||
|
||
**功能扩展**:
|
||
- 可用于用户画像构建
|
||
- 可用于个性化推荐
|
||
- 可用于健康饮食管理
|
||
|
||
---
|
||
|
||
### 🚫 过敏原设置
|
||
|
||
```
|
||
GET api_preference.php?act=allergens&user_id=xxx
|
||
```
|
||
|
||
**功能**: 获取/设置用户过敏原
|
||
|
||
**功能扩展**:
|
||
- 可用于健康警示
|
||
- 可用于食材过滤
|
||
- 可用于购物清单过滤
|
||
|
||
---
|
||
|
||
## 查重接口 api_check_duplicate.php
|
||
|
||
用于用户投稿时查询重复率，支持菜品、食材、营养成分、菜品内容、食材内容查重。
|
||
|
||
### 📋 菜品标题查重
|
||
|
||
```
|
||
GET api_check_duplicate.php?act=recipe_title&title=宫保鸡丁
|
||
```
|
||
|
||
**功能**: 检查菜品标题重复率
|
||
|
||
**参数**:
|
||
| 参数 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| title | string | 菜品标题（必填） |
|
||
|
||
**返回示例**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": {
|
||
"duplicate_rate": 85.5
|
||
},
|
||
"_query_time": "125.34ms"
|
||
}
|
||
```
|
||
|
||
**功能扩展**:
|
||
- 用于投稿前查重提醒
|
||
- 用于防止重复内容录入
|
||
- 用于内容质量把控
|
||
|
||
---
|
||
|
||
### 🥬 食材名称查重
|
||
|
||
```
|
||
GET api_check_duplicate.php?act=ingredient_name&name=鸡蛋
|
||
```
|
||
|
||
**功能**: 检查食材名称重复率
|
||
|
||
**参数**:
|
||
| 参数 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| name | string | 食材名称（必填） |
|
||
|
||
**返回示例**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": {
|
||
"duplicate_rate": 100.0
|
||
},
|
||
"_query_time": "45.23ms"
|
||
}
|
||
```
|
||
|
||
**功能扩展**:
|
||
- 用于食材库查重
|
||
- 用于食材数据质量检查
|
||
- 用于食材关联推荐
|
||
|
||
---
|
||
|
||
### 💊 营养成分查重
|
||
|
||
```
|
||
GET api_check_duplicate.php?act=nutrition_name&name=维生素C
|
||
```
|
||
|
||
**功能**: 检查营养成分名称重复率
|
||
|
||
**参数**:
|
||
| 参数 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| name | string | 营养成分名称（必填） |
|
||
|
||
**返回示例**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": {
|
||
"duplicate_rate": 100.0
|
||
},
|
||
"_query_time": "32.15ms"
|
||
}
|
||
```
|
||
|
||
**功能扩展**:
|
||
- 用于营养成分库查重
|
||
- 用于营养数据标准化
|
||
- 用于营养标签管理
|
||
|
||
---
|
||
|
||
### 📝 菜品内容查重
|
||
|
||
```
|
||
POST api_check_duplicate.php?act=recipe_content
|
||
Content-Type: application/json
|
||
{
|
||
"content": "1. 将鸡肉切成丁状..."
|
||
}
|
||
```
|
||
|
||
**功能**: 检查菜品内容（制作步骤）重复率
|
||
|
||
**参数**:
|
||
| 参数 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| content | string | 菜品内容（必填） |
|
||
|
||
**返回示例**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": {
|
||
"duplicate_rate": 65.3
|
||
},
|
||
"_query_time": "234.56ms"
|
||
}
|
||
```
|
||
|
||
**功能扩展**:
|
||
- 用于菜品内容原创性检查
|
||
- 用于防止抄袭内容
|
||
- 用于内容版权保护
|
||
|
||
---
|
||
|
||
### 📖 食材内容查重
|
||
|
||
```
|
||
POST api_check_duplicate.php?act=ingredient_content
|
||
Content-Type: application/json
|
||
{
|
||
"content": "鸡蛋含有丰富的蛋白质..."
|
||
}
|
||
```
|
||
|
||
**功能**: 检查食材内容（功效、营养、使用提示）重复率
|
||
|
||
**参数**:
|
||
| 参数 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| content | string | 食材内容（必填） |
|
||
|
||
**返回示例**:
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": {
|
||
"duplicate_rate": 42.8
|
||
},
|
||
"_query_time": "189.32ms"
|
||
}
|
||
```
|
||
|
||
**功能扩展**:
|
||
- 用于食材内容原创性检查
|
||
- 用于食材数据质量把控
|
||
- 用于食材百科内容管理
|
||
|
||
---
|
||
|
||
### 🔍 查重算法说明
|
||
|
||
**相似度计算**:
|
||
- 使用PHP `similar_text()` 函数计算文本相似度
|
||
- 返回最高相似度作为重复率
|
||
- 重复率范围：0-100（百分比）
|
||
|
||
**性能优化**:
|
||
- 菜品内容查重限制查询1000条
|
||
- 食材内容查重限制查询1000条
|
||
- 找到100%匹配时提前终止
|
||
|
||
**应用场景**:
|
||
- 📝 用户投稿前查重提醒
|
||
- 🔒 防止重复内容录入
|
||
- 📊 内容质量把控
|
||
- 🛡️ 版权保护
|
||
|
||
---
|
||
|
||
## 功能扩展指南
|
||
|
||
本章节详细介绍每个接口返回字段的具体用途、应用场景和可实现的功能。
|
||
|
||
---
|
||
|
||
### 🍽️ 场景一：用餐时段推荐
|
||
|
||
#### 字段说明
|
||
|
||
`intro` 字段包含菜谱适用的用餐时段信息：
|
||
|
||
```json
|
||
{
|
||
"intro": "早餐、中餐、晚餐"
|
||
}
|
||
```
|
||
|
||
常见值：
|
||
- `"早餐"` - 适合早餐食用
|
||
- `"中餐"` - 适合午餐食用
|
||
- `"晚餐"` - 适合晚餐食用
|
||
- `"早餐、中餐、晚餐"` - 全天适用
|
||
- `"零食"` - 适合零食/下午茶
|
||
|
||
#### 可实现功能
|
||
|
||
| 功能 | 说明 | 实现方式 |
|
||
|------|------|---------|
|
||
| 🌅 早餐推荐 | 根据时段推荐适合早餐的菜谱 | 筛选 `intro` 包含"早餐" |
|
||
| 🍱 午餐推荐 | 根据时段推荐适合午餐的菜谱 | 筛选 `intro` 包含"中餐" |
|
||
| 🌙 晚餐推荐 | 根据时段推荐适合晚餐的菜谱 | 筛选 `intro` 包含"晚餐" |
|
||
| ⏰ 智能时段 | 根据当前时间自动推荐 | 判断当前时段后筛选 |
|
||
| 📅 每日菜单 | 生成一日三餐菜单 | 分别获取早中晚餐菜谱 |
|
||
|
||
#### 实现代码示例
|
||
|
||
```javascript
|
||
// 根据当前时间智能推荐
|
||
function getMealByTime() {
|
||
const hour = new Date().getHours();
|
||
let mealType = '中餐';
|
||
if (hour < 10) mealType = '早餐';
|
||
else if (hour > 17) mealType = '晚餐';
|
||
|
||
// 调用搜索接口
|
||
fetch(`api.php?act=search&keyword=${mealType}`);
|
||
}
|
||
|
||
// 生成一日三餐菜单
|
||
async function getDailyMenu() {
|
||
const [breakfast, lunch, dinner] = await Promise.all([
|
||
fetch('api.php?act=search&keyword=早餐&limit=3'),
|
||
fetch('api.php?act=search&keyword=中餐&limit=3'),
|
||
fetch('api.php?act=search&keyword=晚餐&limit=3')
|
||
]);
|
||
return { breakfast, lunch, dinner };
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 🥗 场景二：健康饮食管理
|
||
|
||
#### 字段说明
|
||
|
||
`allergens` 和 `nutrition` 字段用于健康饮食管理：
|
||
|
||
```json
|
||
{
|
||
"allergens": ["海鲜", "花生"],
|
||
"nutrition": [
|
||
{"name": "热量", "value": 350, "unit": "kcal"},
|
||
{"name": "蛋白质", "value": 25, "unit": "g"},
|
||
{"name": "脂肪", "value": 15, "unit": "g"},
|
||
{"name": "碳水化合物", "value": 30, "unit": "g"}
|
||
]
|
||
}
|
||
```
|
||
|
||
#### 可实现功能
|
||
|
||
| 功能 | 说明 | 应用场景 |
|
||
|------|------|---------|
|
||
| ⚠️ 过敏原警示 | 显示菜谱含有的过敏原 | 用户查看菜谱详情时提醒 |
|
||
| 🚫 过敏原过滤 | 排除含特定过敏原的菜谱 | 用户设置过敏原后自动过滤 |
|
||
| 📊 营养计算 | 计算菜谱营养成分 | 健康饮食、减肥餐规划 |
|
||
| 🔥 热量统计 | 统计每日摄入热量 | 减肥/健身用户热量管理 |
|
||
| 📈 营养分析 | 分析营养均衡度 | 营养师、健康管理App |
|
||
| 💪 健身餐推荐 | 推荐高蛋白低脂菜谱 | 健身人群饮食规划 |
|
||
| 🏥 特殊饮食 | 糖尿病/高血压饮食推荐 | 医疗健康场景 |
|
||
|
||
#### 实现代码示例
|
||
|
||
```javascript
|
||
// 过敏原检查与警示
|
||
function checkAllergens(recipe, userAllergens) {
|
||
const recipeAllergens = recipe.allergens || [];
|
||
const warnings = userAllergens.filter(a => recipeAllergens.includes(a));
|
||
|
||
if (warnings.length > 0) {
|
||
return {
|
||
safe: false,
|
||
warning: `⚠️ 此菜谱含有您过敏的食材：${warnings.join('、')}`
|
||
};
|
||
}
|
||
return { safe: true };
|
||
}
|
||
|
||
// 计算每日营养摄入
|
||
function calculateDailyNutrition(recipes) {
|
||
const total = { calories: 0, protein: 0, fat: 0, carbs: 0 };
|
||
|
||
recipes.forEach(recipe => {
|
||
recipe.nutrition.forEach(n => {
|
||
if (n.name === '热量') total.calories += n.value;
|
||
if (n.name === '蛋白质') total.protein += n.value;
|
||
if (n.name === '脂肪') total.fat += n.value;
|
||
if (n.name === '碳水化合物') total.carbs += n.value;
|
||
});
|
||
});
|
||
|
||
return total;
|
||
}
|
||
|
||
// 推荐低热量菜谱
|
||
async function getLowCalorieRecipes(maxCalories = 300) {
|
||
const response = await fetch('api.php?act=list&limit=50');
|
||
const recipes = response.data.list;
|
||
|
||
return recipes.filter(r => {
|
||
const calories = r.nutrition?.find(n => n.name === '热量')?.value || 0;
|
||
return calories <= maxCalories;
|
||
});
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 📱 场景三：社交分享功能
|
||
|
||
#### 字段说明
|
||
|
||
`code` 和 `statistics` 字段用于社交分享：
|
||
|
||
```json
|
||
{
|
||
"id": 32892,
|
||
"code": "CP032892",
|
||
"title": "宫保鸡丁",
|
||
"statistics": {
|
||
"view_count": 1000,
|
||
"like_count": 50,
|
||
"recommend_count": 30
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 可实现功能
|
||
|
||
| 功能 | 说明 | 应用场景 |
|
||
|------|------|---------|
|
||
| 🔗 分享链接 | 生成唯一分享链接 | 微信/微博分享 |
|
||
| 📱 二维码 | 生成菜谱二维码 | 线下分享、海报 |
|
||
| 🔢 菜谱编码 | 短编码便于传播 | 口口相传、搜索 |
|
||
| 🔥 热度展示 | 显示浏览/点赞数 | 吸引用户点击 |
|
||
| 📊 排行榜 | 热门菜谱排行 | 发现优质内容 |
|
||
| 👍 点赞互动 | 用户点赞功能 | 社交互动 |
|
||
| ⭐ 评分系统 | 五星推荐评分 | 用户评价体系 |
|
||
|
||
#### 实现代码示例
|
||
|
||
```javascript
|
||
// 生成分享链接
|
||
function generateShareLink(recipe) {
|
||
const baseUrl = 'https://eat.wktyl.com/recipe/';
|
||
return `${baseUrl}${recipe.code}`; // https://eat.wktyl.com/recipe/CP032892
|
||
}
|
||
|
||
// 生成二维码内容
|
||
function generateQRCode(recipe) {
|
||
return {
|
||
type: 'recipe',
|
||
code: recipe.code,
|
||
title: recipe.title,
|
||
url: generateShareLink(recipe)
|
||
};
|
||
}
|
||
|
||
// 显示热度标签
|
||
function getHotnessTag(statistics) {
|
||
const { view_count, like_count } = statistics;
|
||
|
||
if (view_count > 10000) return '🔥 爆款';
|
||
if (view_count > 1000) return '📈 热门';
|
||
if (like_count > 100) return '❤️ 受欢迎';
|
||
return null;
|
||
}
|
||
|
||
// 通过编码查询菜谱
|
||
async function getRecipeByCode(code) {
|
||
// code 格式: CP032892
|
||
const id = code.replace('CP', '');
|
||
return fetch(`api.php?act=full&id=${id}`);
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 🛒 场景四：购物清单功能
|
||
|
||
#### 字段说明
|
||
|
||
`ingredients` 字段包含完整食材信息：
|
||
|
||
```json
|
||
{
|
||
"ingredients": {
|
||
"main": [
|
||
{"name": "鸡肉", "amount": "500", "unit": "克"}
|
||
],
|
||
"auxiliary": [
|
||
{"name": "青椒", "amount": "2", "unit": "个"},
|
||
{"name": "红椒", "amount": "1", "unit": "个"}
|
||
],
|
||
"seasoning": [
|
||
{"name": "生抽", "amount": "2", "unit": "勺"},
|
||
{"name": "盐", "amount": "适量", "unit": ""}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 可实现功能
|
||
|
||
| 功能 | 说明 | 应用场景 |
|
||
|------|------|---------|
|
||
| 📝 生成清单 | 一键生成购物清单 | 准备做饭前 |
|
||
| ➕ 合并清单 | 多个菜谱合并购物清单 | 一次采购多道菜 |
|
||
| ✅ 打勾确认 | 购物时逐项确认 | 超市购物 |
|
||
| 📤 分享清单 | 分享给家人采购 | 家庭协作 |
|
||
| 🏪 智能分类 | 按食材类型/超市区域分类 | 提高购物效率 |
|
||
| 💰 预算估算 | 估算食材成本 | 家庭理财 |
|
||
| 🔄 常备食材 | 标记家中已有食材 | 避免重复购买 |
|
||
|
||
#### 实现代码示例
|
||
|
||
```javascript
|
||
// 生成购物清单
|
||
function generateShoppingList(recipe) {
|
||
const { main, auxiliary, seasoning } = recipe.ingredients;
|
||
|
||
return [
|
||
{ category: '主料', items: main },
|
||
{ category: '辅料', items: auxiliary },
|
||
{ category: '调料', items: seasoning }
|
||
];
|
||
}
|
||
|
||
// 合并多个菜谱的购物清单
|
||
function mergeShoppingLists(recipes) {
|
||
const merged = {};
|
||
|
||
recipes.forEach(recipe => {
|
||
const allIngredients = [
|
||
...recipe.ingredients.main,
|
||
...recipe.ingredients.auxiliary,
|
||
...recipe.ingredients.seasoning
|
||
];
|
||
|
||
allIngredients.forEach(item => {
|
||
const key = item.name;
|
||
if (merged[key]) {
|
||
// 合并相同食材
|
||
merged[key].amount += item.amount;
|
||
} else {
|
||
merged[key] = { ...item };
|
||
}
|
||
});
|
||
});
|
||
|
||
return Object.values(merged);
|
||
}
|
||
|
||
// 按超市区域分类
|
||
function categorizeByStoreSection(shoppingList) {
|
||
const sections = {
|
||
'蔬菜区': ['青椒', '红椒', '洋葱', '蒜', '姜'],
|
||
'肉类区': ['鸡肉', '猪肉', '牛肉', '羊肉'],
|
||
'海鲜区': ['鱼', '虾', '蟹'],
|
||
'调料区': ['盐', '酱油', '醋', '料酒']
|
||
};
|
||
|
||
return shoppingList.map(item => {
|
||
for (const [section, items] of Object.entries(sections)) {
|
||
if (items.some(i => item.name.includes(i))) {
|
||
return { ...item, section };
|
||
}
|
||
}
|
||
return { ...item, section: '其他' };
|
||
});
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 📊 场景五：数据分析与运营
|
||
|
||
#### 字段说明
|
||
|
||
统计接口返回的数据：
|
||
|
||
```json
|
||
{
|
||
"total": 30916,
|
||
"today": 69,
|
||
"avg_daily": 59,
|
||
"apis": {"list": 40, "search": 9, "full": 10}
|
||
}
|
||
```
|
||
|
||
热门统计：
|
||
|
||
```json
|
||
{
|
||
"recipe_view": [
|
||
{"id": 4, "name": "姜", "count": 22},
|
||
{"id": 56897, "name": "芪菇炖乌鸡", "count": 21}
|
||
]
|
||
}
|
||
```
|
||
|
||
#### 可实现功能
|
||
|
||
| 功能 | 说明 | 应用场景 |
|
||
|------|------|---------|
|
||
| 📈 实时监控 | 监控API请求量 | 运维监控大屏 |
|
||
| 👥 在线人数 | 显示当前在线用户 | 社交氛围营造 |
|
||
| 🔥 热门趋势 | 分析热门菜谱趋势 | 内容运营 |
|
||
| 📅 日报/周报 | 自动生成运营报告 | 运营分析 |
|
||
| 🎯 用户画像 | 分析用户偏好 | 精准推荐 |
|
||
| 📱 平台分析 | 分析各平台使用情况 | 产品决策 |
|
||
| ⚡ 性能优化 | 分析接口响应时间 | 技术优化 |
|
||
|
||
#### 实现代码示例
|
||
|
||
```javascript
|
||
// 构建运营数据大屏
|
||
async function buildDashboard() {
|
||
const [stats, hot, online] = await Promise.all([
|
||
fetch('stats_full.php?act=request'),
|
||
fetch('stats_full.php?act=hot&period=today'),
|
||
fetch('stats_full.php?act=online')
|
||
]);
|
||
|
||
return {
|
||
totalRecipes: stats.data.total,
|
||
todayRequests: stats.data.today,
|
||
onlineUsers: online.data.online_total,
|
||
topRecipes: hot.data.recipe_view.slice(0, 10)
|
||
};
|
||
}
|
||
|
||
// 分析用户偏好趋势
|
||
function analyzeUserPreference(hotData) {
|
||
const categories = {};
|
||
|
||
hotData.recipe_view.forEach(item => {
|
||
// 统计各分类热度
|
||
const category = item.category_name;
|
||
categories[category] = (categories[category] || 0) + item.count;
|
||
});
|
||
|
||
return Object.entries(categories)
|
||
.sort((a, b) => b[1] - a[1])
|
||
.slice(0, 5);
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 🎯 场景六：智能推荐系统
|
||
|
||
#### 字段说明
|
||
|
||
综合使用多个字段实现智能推荐：
|
||
|
||
```json
|
||
{
|
||
"category": {"id": 11, "name": "家常菜"},
|
||
"tags": [{"id": 2, "name": "原本味"}, {"id": 30, "name": "咖喱味"}],
|
||
"statistics": {"view_count": 1000, "like_count": 50},
|
||
"meta": {
|
||
"process": "炒",
|
||
"taste": "香辣",
|
||
"difficulty": "简单",
|
||
"time": "30分钟"
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 可实现功能
|
||
|
||
| 功能 | 说明 | 应用场景 |
|
||
|------|------|---------|
|
||
| 🎲 随机推荐 | 随机推荐菜谱 | "今天吃什么" |
|
||
| 🏷️ 标签推荐 | 根据标签推荐 | 口味偏好推荐 |
|
||
| 📂 分类推荐 | 根据分类推荐 | 菜系偏好推荐 |
|
||
| ⏱️ 时间推荐 | 根据烹饪时间推荐 | 快手菜推荐 |
|
||
| 📊 热度推荐 | 根据热度推荐 | 发现优质内容 |
|
||
| 👤 个性化推荐 | 基于用户历史推荐 | 千人千面 |
|
||
| 🔄 相似推荐 | 推荐相似菜谱 | 详情页相关推荐 |
|
||
|
||
#### 实现代码示例
|
||
|
||
```javascript
|
||
// 多维度智能推荐
|
||
async function smartRecommend(preferences) {
|
||
const { categories, tags, maxTime, difficulty } = preferences;
|
||
|
||
let url = 'api_what_to_eat.php?act=smart';
|
||
|
||
if (categories?.length) {
|
||
url += `&include_categories=${categories.join(',')}`;
|
||
}
|
||
if (tags?.length) {
|
||
url += `&include_tags=${tags.join(',')}`;
|
||
}
|
||
if (maxTime) {
|
||
url += `&max_time=${maxTime}`;
|
||
}
|
||
|
||
const response = await fetch(url);
|
||
return response.data;
|
||
}
|
||
|
||
// 相似菜谱推荐
|
||
async function getSimilarRecipes(recipeId) {
|
||
// 1. 获取当前菜谱信息
|
||
const current = await fetch(`api.php?act=full&id=${recipeId}`);
|
||
|
||
// 2. 根据分类和标签查找相似
|
||
const similar = await fetch(`api.php?act=list&cate_id=${current.category.id}&limit=10`);
|
||
|
||
// 3. 排除当前菜谱
|
||
return similar.data.list.filter(r => r.id !== recipeId);
|
||
}
|
||
|
||
// 快手菜推荐（30分钟内）
|
||
async function getQuickRecipes() {
|
||
const response = await fetch('api.php?act=list&limit=50');
|
||
|
||
return response.data.list.filter(recipe => {
|
||
const time = recipe.meta?.time;
|
||
if (!time) return false;
|
||
const minutes = parseInt(time);
|
||
return minutes <= 30;
|
||
});
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 📝 场景七：菜谱内容展示
|
||
|
||
#### 字段说明
|
||
|
||
`content` 字段包含菜谱详细步骤：
|
||
|
||
```json
|
||
{
|
||
"content": "<p>1.将白菜顺切成宽1.5厘米...</p><p>2.将勺置火上加入清水...</p>",
|
||
"intro": "早餐、中餐、晚餐",
|
||
"meta": {
|
||
"process": "炒",
|
||
"taste": "香辣",
|
||
"difficulty": "简单"
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 可实现功能
|
||
|
||
| 功能 | 说明 | 应用场景 |
|
||
|------|------|---------|
|
||
| 📖 步骤解析 | 解析烹饪步骤 | 详情页展示 |
|
||
| 🔢 步骤编号 | 自动编号步骤 | 用户操作引导 |
|
||
| ⏰ 时间提示 | 提取步骤中的时间 | 计时器功能 |
|
||
| 🎙️ 语音播报 | 语音朗读步骤 | 做饭时解放双手 |
|
||
| 📸 步骤图片 | 提取步骤配图 | 图文教程 |
|
||
| 🖨️ 打印菜谱 | 生成可打印版本 | 纸质菜谱 |
|
||
| 📤 导出分享 | 导出为文本/图片 | 社交分享 |
|
||
|
||
#### 实现代码示例
|
||
|
||
```javascript
|
||
// 解析步骤
|
||
function parseSteps(content) {
|
||
// 移除HTML标签
|
||
const text = content.replace(/<[^>]+>/g, '');
|
||
|
||
// 按步骤分割
|
||
const steps = text.split(/[1-9][.、]/).filter(s => s.trim());
|
||
|
||
return steps.map((step, index) => ({
|
||
number: index + 1,
|
||
content: step.trim(),
|
||
time: extractTime(step) // 提取时间
|
||
}));
|
||
}
|
||
|
||
// 提取步骤中的时间
|
||
function extractTime(text) {
|
||
const patterns = [
|
||
/(\d+)\s*分钟/,
|
||
/(\d+)\s*秒/,
|
||
/(\d+)\s*小时/
|
||
];
|
||
|
||
for (const pattern of patterns) {
|
||
const match = text.match(pattern);
|
||
if (match) return match[0];
|
||
}
|
||
return null;
|
||
}
|
||
|
||
// 生成计时器提醒
|
||
function generateTimers(steps) {
|
||
return steps
|
||
.filter(step => step.time)
|
||
.map(step => ({
|
||
step: step.number,
|
||
duration: step.time,
|
||
label: `步骤${step.number}需要${step.time}`
|
||
}));
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 🔍 场景八：搜索与发现
|
||
|
||
#### 字段说明
|
||
|
||
搜索相关字段：
|
||
|
||
```json
|
||
{
|
||
"title": "宫保鸡丁",
|
||
"intro": "中餐、晚餐",
|
||
"category": {"id": 11, "name": "家常菜"},
|
||
"tags": [{"id": 2, "name": "原本味"}]
|
||
}
|
||
```
|
||
|
||
#### 可实现功能
|
||
|
||
| 功能 | 说明 | 应用场景 |
|
||
|------|------|---------|
|
||
| 🔎 关键词搜索 | 按菜名/食材搜索 | 快速查找 |
|
||
| 🏷️ 标签搜索 | 按标签筛选 | 口味筛选 |
|
||
| 📂 分类浏览 | 按分类浏览 | 菜系浏览 |
|
||
| 📜 搜索历史 | 记录搜索历史 | 快速重搜 |
|
||
| 🔥 热门搜索 | 显示热门关键词 | 发现内容 |
|
||
| 💡 搜索建议 | 输入时提供建议 | 提升体验 |
|
||
| 🎤 语音搜索 | 语音输入搜索 | 解放双手 |
|
||
|
||
#### 实现代码示例
|
||
|
||
```javascript
|
||
// 搜索建议
|
||
async function getSearchSuggestions(keyword) {
|
||
if (keyword.length < 2) return [];
|
||
|
||
const response = await fetch(`api.php?act=search&keyword=${keyword}&limit=5`);
|
||
|
||
return response.data.list.map(item => ({
|
||
id: item.id,
|
||
title: item.title,
|
||
type: 'recipe'
|
||
}));
|
||
}
|
||
|
||
// 热门搜索关键词
|
||
function getHotKeywords(hotData) {
|
||
return hotData.recipe_view
|
||
.slice(0, 10)
|
||
.map(item => item.name);
|
||
}
|
||
|
||
// 多条件组合搜索
|
||
function buildSearchQuery(filters) {
|
||
const params = new URLSearchParams();
|
||
|
||
if (filters.keyword) params.set('keyword', filters.keyword);
|
||
if (filters.category) params.set('cate_id', filters.category);
|
||
if (filters.tag) params.set('tag_id', filters.tag);
|
||
|
||
return `api.php?act=search&${params.toString()}`;
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 📋 字段功能速查表
|
||
|
||
| 字段 | 可实现功能 | 推荐接口 |
|
||
|------|-----------|---------|
|
||
| `id` | 详情查询、收藏、分享链接 | `api.php?act=detail` |
|
||
| `code` | 二维码、短链接、语音搜索 | `api_what_to_eat.php?act=detail&code=` |
|
||
| `title` | 搜索、分享标题、列表展示 | `api.php?act=search` |
|
||
| `intro` | 用餐时段筛选、列表预览 | 客户端过滤 |
|
||
| `category` | 分类筛选、面包屑导航 | `api.php?act=list&cate_id=` |
|
||
| `tags` | 标签云、口味筛选、相关推荐 | `api.php?act=list&tag_id=` |
|
||
| `allergens` | 过敏警示、健康过滤 | `api.php?act=full` |
|
||
| `nutrition` | 营养计算、健康分析 | `api.php?act=full` |
|
||
| `ingredients` | 购物清单、营养计算 | `api.php?act=full` |
|
||
| `statistics` | 热门排序、热度展示 | `stats_full.php?act=hot` |
|
||
| `meta.process` | 工艺筛选（炒/蒸/煮） | 客户端过滤 |
|
||
| `meta.taste` | 口味筛选（酸甜苦辣咸） | 客户端过滤 |
|
||
| `meta.difficulty` | 难度筛选、新手推荐 | 客户端过滤 |
|
||
| `meta.time` | 时间筛选、快手菜推荐 | 客户端过滤 |
|
||
| `content` | 步骤解析、语音播报 | `api.php?act=detail` |
|
||
|
||
---
|
||
|
||
## 错误处理
|
||
|
||
### 错误码
|
||
|
||
| 错误码 | 说明 |
|
||
|--------|------|
|
||
| 200 | 成功 |
|
||
| 301 | 重定向 |
|
||
| 400 | 参数错误 |
|
||
| 404 | 资源不存在 |
|
||
| 429 | 请求过于频繁 |
|
||
| 500 | 服务器错误 |
|
||
|
||
### 错误响应
|
||
|
||
```json
|
||
{
|
||
"code": 404,
|
||
"message": "菜谱不存在",
|
||
"data": null
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 缓存时间
|
||
|
||
| 接口 | 缓存时间 |
|
||
|------|---------|
|
||
| list | 3分钟 |
|
||
| detail | 5分钟 |
|
||
| full | 10分钟 |
|
||
| ingredients | 5分钟 |
|
||
| search | 2分钟 |
|
||
| categories | 10分钟 |
|
||
| stats | 1分钟 |
|
||
| hot | 5分钟 |
|
||
| online | 30秒 |
|
||
|
||
---
|
||
|
||
## 📦 数据资源文件
|
||
|
||
本章节介绍API提供的静态数据资源文件，这些文件包含菜谱系统的核心基础数据，可配合API接口实现更丰富的功能。
|
||
|
||
---
|
||
|
||
### 🍽️ 用餐时段数据
|
||
|
||
**文件地址**: `http://eat.wktyl.com/api/assets/eating_times.json`
|
||
|
||
**数据结构**:
|
||
```json
|
||
{
|
||
"standard_times": [
|
||
{"id": 1, "name": "中餐", "count": 2485},
|
||
{"id": 2, "name": "晚餐", "count": 2422},
|
||
{"id": 3, "name": "早餐", "count": 1408},
|
||
{"id": 4, "name": "零食", "count": 244}
|
||
],
|
||
"combined_times": [...],
|
||
"frequency_times": [...],
|
||
"method_times": [...],
|
||
"other_times": [...]
|
||
}
|
||
```
|
||
|
||
**数据分类**:
|
||
|
||
| 分类 | 说明 | 数量 | 用途 |
|
||
|------|------|------|------|
|
||
| standard_times | 标准用餐时段 | 9个 | 早中晚餐、零食等标准时段 |
|
||
| combined_times | 组合时段 | 3个 | 多时段组合（如中晚餐均可） |
|
||
| frequency_times | 食用频率 | 11个 | 药膳频率（每日2次、连服10天等） |
|
||
| method_times | 食用方式 | 8个 | 食用方法（佐餐、温服等） |
|
||
| other_times | 其他时段 | 3个 | 特殊描述 |
|
||
|
||
**配合API使用**:
|
||
|
||
1. **时段筛选功能**
|
||
```javascript
|
||
// 获取用餐时段列表
|
||
const eatingTimes = await fetch('http://eat.wktyl.com/api/assets/eating_times.json');
|
||
const times = await eatingTimes.json();
|
||
|
||
// 用户选择时段后，调用API筛选菜谱
|
||
const selectedTime = times.standard_times[0].name; // "中餐"
|
||
const recipes = await fetch(`api.php?act=search&keyword=${selectedTime}`);
|
||
```
|
||
|
||
2. **智能时段推荐**
|
||
```javascript
|
||
// 根据当前时间自动推荐
|
||
function getMealByTime() {
|
||
const hour = new Date().getHours();
|
||
let mealType = '中餐';
|
||
if (hour < 10) mealType = '早餐';
|
||
else if (hour > 17) mealType = '晚餐';
|
||
|
||
// 使用时段数据验证
|
||
const times = await getEatingTimes();
|
||
const isValid = times.standard_times.some(t => t.name === mealType);
|
||
|
||
if (isValid) {
|
||
return fetch(`api.php?act=search&keyword=${mealType}`);
|
||
}
|
||
}
|
||
```
|
||
|
||
3. **用餐时段选择器**
|
||
```javascript
|
||
// 构建时段选择UI
|
||
function buildTimeSelector() {
|
||
const times = await getEatingTimes();
|
||
|
||
return {
|
||
standard: times.standard_times.map(t => ({
|
||
label: t.name,
|
||
count: t.count,
|
||
value: t.name
|
||
})),
|
||
frequency: times.frequency_times.map(t => ({
|
||
label: t.name,
|
||
count: t.count,
|
||
value: t.name
|
||
}))
|
||
};
|
||
}
|
||
```
|
||
|
||
**应用场景**:
|
||
- 🕐 智能时段推荐：根据当前时间自动推荐适合的菜谱
|
||
- 📅 每日菜单规划：生成早中晚餐完整菜单
|
||
- 🏥 药膳管理：根据食用频率规划药膳食谱
|
||
- 📊 时段统计分析：分析不同时段的菜谱分布
|
||
|
||
---
|
||
|
||
### 🥗 营养成分数据
|
||
|
||
**文件地址**: `http://eat.wktyl.com/api/assets/nutrition_types.json`
|
||
|
||
**数据结构**:
|
||
```json
|
||
[
|
||
{"id": 1, "name": "叶酸", "unit": "微克"},
|
||
{"id": 2, "name": "核黄素", "unit": "毫克"},
|
||
{"id": 3, "name": "泛酸", "unit": "毫克"},
|
||
{"id": 4, "name": "烟酸", "unit": "毫克"},
|
||
{"id": 5, "name": "生物素", "unit": "微克"},
|
||
...
|
||
]
|
||
```
|
||
|
||
**数据统计**: 共31种营养成分类型
|
||
|
||
**营养成分分类**:
|
||
|
||
| 分类 | 成分 | 数量 |
|
||
|------|------|------|
|
||
| 维生素类 | 维生素A、B、C、D、E、K、叶酸等 | 12种 |
|
||
| 矿物质类 | 钙、铁、锌、硒、碘、铜、锰、镁等 | 8种 |
|
||
| 宏量营养素 | 蛋白质、脂肪、碳水化合物、膳食纤维 | 4种 |
|
||
| 其他 | 能量、胆固醇、胡萝卜素等 | 7种 |
|
||
|
||
**配合API使用**:
|
||
|
||
1. **营养分析功能**
|
||
```javascript
|
||
// 获取营养成分类型
|
||
const nutritionTypes = await fetch('http://eat.wktyl.com/api/assets/nutrition_types.json');
|
||
const types = await nutritionTypes.json();
|
||
|
||
// 获取菜谱营养信息
|
||
const recipe = await fetch('api.php?act=full&id=32892');
|
||
const recipeData = await recipe.json();
|
||
|
||
// 匹配营养成分单位
|
||
recipeData.nutrition.forEach(n => {
|
||
const type = types.find(t => t.name === n.name);
|
||
if (type) {
|
||
n.unit = type.unit;
|
||
n.id = type.id;
|
||
}
|
||
});
|
||
```
|
||
|
||
2. **营养目标追踪**
|
||
```javascript
|
||
// 用户设置营养目标
|
||
const nutritionGoals = [
|
||
{name: "蛋白质", target: 60, unit: "克"},
|
||
{name: "维生素C", target: 100, unit: "毫克"}
|
||
];
|
||
|
||
// 计算菜谱营养贡献
|
||
function calculateNutrition(recipe) {
|
||
const types = await getNutritionTypes();
|
||
const contribution = {};
|
||
|
||
recipe.nutrition.forEach(n => {
|
||
const type = types.find(t => t.name === n.name);
|
||
const goal = nutritionGoals.find(g => g.name === n.name);
|
||
|
||
if (goal && type) {
|
||
contribution[n.name] = {
|
||
value: n.value,
|
||
unit: type.unit,
|
||
percentage: (n.value / goal.target * 100).toFixed(1) + '%'
|
||
};
|
||
}
|
||
});
|
||
|
||
return contribution;
|
||
}
|
||
```
|
||
|
||
3. **营养筛选器**
|
||
```javascript
|
||
// 构建营养筛选UI
|
||
function buildNutritionFilter() {
|
||
const types = await getNutritionTypes();
|
||
|
||
return types.map(t => ({
|
||
id: t.id,
|
||
label: t.name,
|
||
unit: t.unit,
|
||
type: categorizeNutrition(t.name) // 维生素/矿物质/宏量营养素
|
||
}));
|
||
}
|
||
|
||
function categorizeNutrition(name) {
|
||
if (name.includes('维生素') || name.includes('叶酸')) return 'vitamin';
|
||
if (['钙', '铁', '锌', '硒', '碘', '铜', '锰', '镁'].includes(name)) return 'mineral';
|
||
if (['蛋白质', '脂肪', '碳水化合物', '膳食纤维'].includes(name)) return 'macro';
|
||
return 'other';
|
||
}
|
||
```
|
||
|
||
**应用场景**:
|
||
- 📊 营养分析：计算菜谱营养成分及占比
|
||
- 🎯 营养目标：追踪每日营养摄入目标
|
||
- 🏋️ 健身餐规划：高蛋白、低碳水化合物菜谱推荐
|
||
- 🏥 健康管理：糖尿病、高血压等特殊饮食规划
|
||
- 👶 孕期营养：叶酸、铁、钙等关键营养素追踪
|
||
|
||
---
|
||
|
||
### ⚠️ 过敏原数据
|
||
|
||
**文件地址**: `http://eat.wktyl.com/api/assets/gmy.json`
|
||
|
||
**数据结构**:
|
||
```json
|
||
[
|
||
{
|
||
"name": "蔬菜类及制品",
|
||
"items": [
|
||
{
|
||
"name": "姜",
|
||
"allergens": ["姜"],
|
||
"allergen_type": ["蔬菜类"]
|
||
},
|
||
{
|
||
"name": "洋葱（白皮）",
|
||
"allergens": ["葱", "洋葱"],
|
||
"allergen_type": ["蔬菜类"]
|
||
}
|
||
]
|
||
}
|
||
]
|
||
```
|
||
|
||
**数据统计**:
|
||
- 总分类数：21个
|
||
- 总食材数：585种（仅含过敏原信息）
|
||
- 过敏原类型：蔬菜类、水果类、谷物类、菌类、豆类、海鲜类、肉类等
|
||
|
||
**主要分类**:
|
||
|
||
| 分类 | 食材数 | 常见过敏原 |
|
||
|------|--------|-----------|
|
||
| 蔬菜类及制品 | 63 | 姜、葱、蒜、韭菜、芹菜、茄子等 |
|
||
| 水果类及制品 | 28 | 菠萝、芒果、桃、草莓、荔枝等 |
|
||
| 干豆类及制品 | 33 | 黄豆、绿豆、豌豆、蚕豆等 |
|
||
| 鱼虾蟹贝类 | 101 | 各类海鲜、鱼类、虾蟹等 |
|
||
| 畜肉类及制品 | 88 | 牛肉、羊肉、猪肉等 |
|
||
| 禽肉类及制品 | 55 | 鸡肉、鸭肉、鹅肉等 |
|
||
| 蛋类及制品 | 10 | 鸡蛋、鸭蛋、鹌鹑蛋等 |
|
||
| 乳类及制品 | 10 | 牛奶、羊奶、奶酪等 |
|
||
| 坚果种子类 | 22 | 花生、核桃、杏仁等 |
|
||
| 调味品类 | 57 | 酱油、醋、味精等 |
|
||
|
||
**配合API使用**:
|
||
|
||
1. **过敏原检查**
|
||
```javascript
|
||
// 获取过敏原数据
|
||
const allergenData = await fetch('http://eat.wktyl.com/api/assets/gmy.json');
|
||
const allergens = await allergenData.json();
|
||
|
||
// 检查食材是否含过敏原
|
||
function checkAllergen(ingredientName, userAllergens) {
|
||
for (const category of allergens) {
|
||
const item = category.items.find(i => i.name === ingredientName);
|
||
if (item && item.allergens) {
|
||
const hasAllergen = item.allergens.some(a => userAllergens.includes(a));
|
||
if (hasAllergen) {
|
||
return {
|
||
safe: false,
|
||
allergens: item.allergens.filter(a => userAllergens.includes(a)),
|
||
types: item.allergen_type
|
||
};
|
||
}
|
||
}
|
||
}
|
||
return { safe: true };
|
||
}
|
||
```
|
||
|
||
2. **菜谱过敏原过滤**
|
||
```javascript
|
||
// 获取菜谱详情
|
||
const recipe = await fetch('api.php?act=full&id=32892');
|
||
const recipeData = await recipe.json();
|
||
|
||
// 检查菜谱是否安全
|
||
function checkRecipeSafety(recipe, userAllergens) {
|
||
const allergenData = await getAllergenData();
|
||
const warnings = [];
|
||
|
||
// 检查所有食材
|
||
recipe.ingredients.forEach(ing => {
|
||
const check = checkAllergen(ing.name, userAllergens);
|
||
if (!check.safe) {
|
||
warnings.push({
|
||
ingredient: ing.name,
|
||
allergens: check.allergens,
|
||
types: check.types
|
||
});
|
||
}
|
||
});
|
||
|
||
return {
|
||
safe: warnings.length === 0,
|
||
warnings: warnings
|
||
};
|
||
}
|
||
```
|
||
|
||
3. **过敏原设置界面**
|
||
```javascript
|
||
// 构建过敏原选择UI
|
||
function buildAllergenSelector() {
|
||
const allergenData = await getAllergenData();
|
||
const allergenTypes = new Set();
|
||
|
||
// 收集所有过敏原类型
|
||
allergenData.forEach(category => {
|
||
category.items.forEach(item => {
|
||
item.allergen_type.forEach(type => allergenTypes.add(type));
|
||
});
|
||
});
|
||
|
||
return Array.from(allergenTypes).map(type => ({
|
||
label: type,
|
||
value: type,
|
||
count: countItemsByType(allergenData, type)
|
||
}));
|
||
}
|
||
```
|
||
|
||
4. **智能替代推荐**
|
||
```javascript
|
||
// 为含过敏原食材推荐替代品
|
||
function suggestAlternatives(ingredient, userAllergens) {
|
||
const allergenData = await getAllergenData();
|
||
const category = findCategory(allergenData, ingredient);
|
||
|
||
if (!category) return [];
|
||
|
||
// 查找同类但不含过敏原的食材
|
||
return category.items.filter(item => {
|
||
const hasAllergen = item.allergens.some(a => userAllergens.includes(a));
|
||
return !hasAllergen && item.name !== ingredient;
|
||
}).slice(0, 5);
|
||
}
|
||
```
|
||
|
||
**应用场景**:
|
||
- ⚠️ 过敏原警示：用户查看菜谱时显示过敏原提醒
|
||
- 🚫 智能过滤：自动过滤含用户过敏原的菜谱
|
||
- 🔄 食材替代：推荐不含过敏原的替代食材
|
||
- 📋 过敏原报告：生成菜谱过敏原分析报告
|
||
- 👶 儿童饮食：儿童常见过敏原特殊处理
|
||
- 🏥 医疗饮食：为特殊人群定制安全食谱
|
||
|
||
---
|
||
|
||
### 🔗 数据文件与API协同使用
|
||
|
||
**完整工作流程**:
|
||
|
||
```javascript
|
||
// 1. 初始化：加载基础数据
|
||
async function initializeApp() {
|
||
const [eatingTimes, nutritionTypes, allergenData] = await Promise.all([
|
||
fetch('http://eat.wktyl.com/api/assets/eating_times.json').then(r => r.json()),
|
||
fetch('http://eat.wktyl.com/api/assets/nutrition_types.json').then(r => r.json()),
|
||
fetch('http://eat.wktyl.com/api/assets/gmy.json').then(r => r.json())
|
||
]);
|
||
|
||
return { eatingTimes, nutritionTypes, allergenData };
|
||
}
|
||
|
||
// 2. 智能推荐：结合时段、营养、过敏原
|
||
async function smartRecommend(userProfile) {
|
||
const data = await initializeApp();
|
||
|
||
// 根据时段推荐
|
||
const currentMeal = getCurrentMealType(data.eatingTimes);
|
||
|
||
// 获取推荐菜谱
|
||
const recipes = await fetch(`api.php?act=search&keyword=${currentMeal}`);
|
||
|
||
// 过滤过敏原
|
||
const safeRecipes = recipes.filter(recipe => {
|
||
const safety = checkRecipeSafety(recipe, userProfile.allergens, data.allergenData);
|
||
return safety.safe;
|
||
});
|
||
|
||
// 计算营养匹配度
|
||
const scoredRecipes = safeRecipes.map(recipe => ({
|
||
...recipe,
|
||
nutritionScore: calculateNutritionScore(recipe, userProfile.nutritionGoals, data.nutritionTypes)
|
||
}));
|
||
|
||
// 排序返回
|
||
return scoredRecipes.sort((a, b) => b.nutritionScore - a.nutritionScore);
|
||
}
|
||
|
||
// 3. 生成个性化报告
|
||
async function generateReport(recipeId, userProfile) {
|
||
const data = await initializeApp();
|
||
const recipe = await fetch(`api.php?act=full&id=${recipeId}`).then(r => r.json());
|
||
|
||
return {
|
||
mealTime: matchMealTime(recipe, data.eatingTimes),
|
||
nutrition: analyzeNutrition(recipe, data.nutritionTypes, userProfile.goals),
|
||
allergens: checkAllergens(recipe, data.allergenData, userProfile.allergens),
|
||
suggestions: generateSuggestions(recipe, data, userProfile)
|
||
};
|
||
}
|
||
```
|
||
|
||
**最佳实践**:
|
||
|
||
1. **数据缓存策略**
|
||
```javascript
|
||
// 本地缓存基础数据，减少网络请求
|
||
const CACHE_KEY = 'recipe_base_data';
|
||
const CACHE_DURATION = 24 * 60 * 60 * 1000; // 24小时
|
||
|
||
async function getBaseData() {
|
||
const cached = localStorage.getItem(CACHE_KEY);
|
||
if (cached) {
|
||
const { data, timestamp } = JSON.parse(cached);
|
||
if (Date.now() - timestamp < CACHE_DURATION) {
|
||
return data;
|
||
}
|
||
}
|
||
|
||
const data = await initializeApp();
|
||
localStorage.setItem(CACHE_KEY, JSON.stringify({
|
||
data,
|
||
timestamp: Date.now()
|
||
}));
|
||
|
||
return data;
|
||
}
|
||
```
|
||
|
||
2. **增量更新**
|
||
```javascript
|
||
// 定期检查数据更新
|
||
async function checkForUpdates() {
|
||
const response = await fetch('http://eat.wktyl.com/api/assets/version.json');
|
||
const { version } = await response.json();
|
||
|
||
const currentVersion = localStorage.getItem('data_version');
|
||
if (version !== currentVersion) {
|
||
localStorage.clear();
|
||
await getBaseData();
|
||
localStorage.setItem('data_version', version);
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 过敏原类型
|
||
|
||
| 类型 | 说明 |
|
||
|------|------|
|
||
| seafood | 海鲜 |
|
||
| nuts | 坚果 |
|
||
| dairy | 乳制品 |
|
||
| egg | 蛋类 |
|
||
| gluten | 麸质 |
|
||
| soy | 大豆 |
|
||
| peanut | 花生 |
|
||
|
||
---
|
||
|
||
## 菜谱编码格式
|
||
|
||
格式：`CP` + 6位数字
|
||
|
||
示例：`CP032892` 对应 ID `32892`
|
||
|
||
**用途**:
|
||
- 唯一标识分享
|
||
- 二维码生成
|
||
- 语音搜索识别
|
||
- 快速定位菜谱
|