导入
附加请求参数
了解 Spoonacular API 某些端点的其他重要请求参数的详细信息。
分页参数
| 参数 | 类型 | 类别 | 描述 |
|---|---|---|---|
| offset | Number | 可选 | API 响应中要跳过的结果数量。有效值：0–900 |
| number | Number | 可选 | API 响应中要包含的结果数量。有效值：0–100 |
这些请求参数适用于所有获取对象列表的端点。
食谱搜索的营养成分参数
| 参数 | 类型 | 类别 | 描述 |
|---|---|---|---|
| minCarbs | Number | 可选 | 获取的食谱所需的最低碳水化合物含量（单位：克）。 |
| maxCarbs | Number | 可选 | 获取的食谱所需的最大碳水化合物含量（单位：克）。 |
| minCalories | Number | 可选 | 获取的食谱所需的最低热量值。 |
| maxCalories | Number | 可选 | 获取的食谱所需的最大热量值。 |
| minProtein | Number | 可选 | 获取的食谱所需的最低蛋白质含量（单位：克）。 |
| maxProtein | Number | 可选 | 获取的食谱所需的最大蛋白质含量（单位：克）。 |
| minCholesterol | Number | 可选 | 获取的食谱所需的最低胆固醇含量（单位：毫克）。 |
| maxCholesterol | Number | 可选 | 获取的食谱所需的最大胆固醇含量（单位：毫克）。 |
| minFat | Number | 可选 | 获取的食谱所需的最低脂肪含量（单位：克）。 |
| maxFat | Number | 可选 | 获取的食谱所需的最大脂肪含量（单位：克）。 |
| minAlcohol | Number | 可选 | 获取的食谱所需的最低酒精含量（单位：克）。 |
| maxAlcohol | Number | 可选 | 获取的食谱所需的最大酒精含量（单位：克）。 |
| minCaffeine | Number | 可选 | 获取的食谱所需的最低咖啡因含量（单位：毫克）。 |
| maxCaffeine | Number | 可选 | 获取的食谱所需的最大咖啡因含量（单位：毫克）。 |
| minSaturatedFat | Number | 可选 | 获取的食谱所需的最低饱和脂肪含量（单位：克）。 |
| maxSaturatedFat | Number | 可选 | 获取的食谱所需的最大饱和脂肪含量（单位：克）。 |
这些请求参数支持以下端点：
| 名称 | 路径 |
|---|---|
| 食谱搜索 | /recipes/complexSearch |
| 按营养成分搜索食谱 | /recipes/findByNutrients |
这些请求参数支持以下端点：
| 名称 | 路径 |
|---|---|
| 食谱搜索 | /recipes/complexSearch |
| 按营养成分搜索食谱 | /recipes/findByNutrients |
食谱搜索端点的额外高级参数
| 参数 | 类型 | 类别 | 描述 |
|---|---|---|---|
| instructionsRequired | Boolean | 可选 | 若设为 true，则在响应中包含食谱步骤说明。 |
| fillIngredients | Boolean | 可选 | 若设为 true，则包含查询食谱中食材是否缺失或已包含的附加信息。启用此参数时，每个食谱将额外消耗 0.025 配额点。 |
| addRecipeInformation | Boolean | 可选 | 若设为 true，则包含查询食谱的详细信息。启用此参数时，每个食谱将额外消耗 0.025 配额点。 |
| addRecipeNutrition | Boolean | 可选 | 若设为 true，则包含查询食谱的营养信息。启用此参数时，每个食谱将额外消耗 0.025 配额点。 |
| author | String | 可选 | 食谱作者在 Spoonacular 上的用户名。 |
| tags | String | 可选 | 用于匹配搜索结果的自定义标签。使用此参数需同时提供 author 参数。 |
| recipeBoxId | Number | 可选 | 指定在 Spoonacular 上的食谱盒 ID，用于限制搜索结果范围。 |
| titleMatch | String | 可选 | 用于匹配搜索结果中食谱标题的自定义字符串。使用此参数需同时提供 author 参数。 |
| maxReadyTime | Number | 可选 | 查询食谱烹饪所需的最大时间（单位：分钟）。 |
| ignorePantry | Boolean | 可选 | 若设为 true，搜索结果将排除水、盐等常见 pantry 食材。 |
| sort | String | 可选 | 用于对结果进行排序的选项。 |
| sortDirection | String | 可选 | 排序方向。使用 asc 表示升序，使用 desc 表示降序。 |
这些请求参数支持以下端点：
| 名称 | 路径 |
|---|---|
| 食谱搜索 | /recipes/complexSearch |
这些请求参数支持以下端点：
| 名称 | 路径 |
|---|---|
| 食谱搜索 | /recipes/complexSearch |