导入
请求与响应结构
学习TheMealDB API的请求和响应结构。
请求结构
TheMealDB API 的请求包含用户想要调用的端点。每个端点具有不同的功能。以下是可使用的基础 URL 列表:
| 功能 | 基础 URL |
|---|---|
| 获取所有类别、菜系或食材列表 | www.themealdb.com/api/json/v1/1/list.php |
| 按类别、菜系或食材过滤菜品 | www.themealdb.com/api/json/v1/1/filter.php |
| 根据 ID 查找菜品详情或食材信息 | www.themealdb.com/api/json/v1/1/lookup.php |
| 按首字母或名称搜索菜品 | www.themealdb.com/api/json/v1/1/search.php |
| 获取随机菜品 | www.themealdb.com/api/json/v1/1/random.php |
注意: 这些地址中
www.themealdb.com/api/json/v1/后面的 API 密钥1是用于身份验证的开发用 API 密钥。
这些端点会与查询参数结合,以获取我们所需的数据。
响应结构
响应结构会根据搜索条件是否在数据库中匹配到菜品而有所不同。
请求失败的情况
如果搜索条件在数据库中没有匹配到任何菜品,返回结果中将仅包含一个元素,即 meals,其值为 null。
请求成功的情况
对于成功的请求,不同端点会返回不同的数据。我们将在后续课程中详细讨论各个端点成功请求后的具体返回结果。