导入
请求与响应结构
了解TheCocktailDB API的请求和响应结构。
请求结构
TheCocktailDB API 的请求包含用户想要调用的端点。每个端点执行不同的功能。以下是可使用的基础 URL 列表：
| 功能 | 基础 URI |
|---|---|
| 根据成分、首字母或名称搜索鸡尾酒 | www.thecocktaildb.com/api/json/v1/1/search.php |
| 根据数据库 ID 查找鸡尾酒或成分 | www.thecocktaildb.com/api/json/v1/1/lookup.php |
| 获取随机鸡尾酒配方 | www.thecocktaildb.com/api/json/v1/1/random.php |
| 按成分、酒精类型、分类或酒杯类型筛选鸡尾酒 | www.thecocktaildb.com/api/json/v1/1/filter.php |
| 列出可用的分类、酒杯、成分或酒精类型过滤选项 | www.thecocktaildb.com/api/json/v1/1/list.php |
注意： 这些地址中
www.thecocktaildb.com/api/json/v1/后面的 API 密钥1是我们在前一课中提到的开发版 API。
这些基础 URI 会与查询参数结合，以获取我们所需的数据。
响应结构
响应结构会根据搜索条件是否匹配数据库中的任何鸡尾酒而有所不同。
请求失败的情况
如果搜索条件在数据库中没有匹配到任何饮品，则结果中仅包含一个元素，即 drinks 或 ingredients，具体取决于搜索是关于饮品还是成分。返回对象的值为 null。
请求成功的情况
对于成功的请求，不同端点将返回不同的数据。我们将在接下来的课程中详细讨论这些端点的成功请求结果。