如果您使用智能手机，您会整天使用 API，甚至浑然不觉。当您订购 Uber 时，该应用程序使用 Google Maps API 来显示地图，并使用 Stripe 或 Adyen API 来处理付款。
但这对于构建应用程序的人来说意味着什么呢？ API 如何融入日常开发和产品生命周期？
在本实用指南中，我们将从理论象牙塔中走下来，展示 API 如何在日常移动开发的工厂车间中工作。
什么是API（电梯讲解）
API 代表应用程序编程接口。 把她想象成一个服务员。
- 您（应用程序）坐在桌旁查看菜单。
- 厨房（服务器/数据库）有食材并准备菜肴。 3.不能进入厨房。
- 服务员（API）接受您的订单（“我想要用户列表”），将其带到厨房，等待菜肴准备好并将其返回给您。
没有服务员，你就会挨饿。如果没有 API，应用程序就是一张空画布。
一步一步：将 API 集成到日常生活中
让我们通过集成“天气预报”功能来模拟移动开发人员的日常工作。
第 1 步：阅读文档（手册）
在写代码之前，你需要知道服务员可以带来什么。 API 文档（如 OpenWeatherMap 的文档）说道：
- 端点：调用哪个 URL？ （例如：2）
- 方法：是读（3）还是发送（44）请求？
- 参数：我需要发送什么？ （例如：556）
- 答案：我能得到什么回报？ （包含温度、湿度等的 JSON）。
第 2 步：对邮递员/失眠进行测试
不要尝试直接集成到应用程序中。测试一下。 Postman 等工具允许您模拟 API 调用。
- 您输入 URL 和 API 密钥（Key）。
- 点击“发送”。
- 查看响应 JSON。 如果它在这里工作，则问题出在您的代码中。如果这里不起作用，则问题出在 API 或您的请求上。
步骤 3：创建模型（数据类）
应用程序需要理解返回的 JSON。 如果 JSON 是： 0 您可以在 Swift (iOS) 或 Kotlin (Android) 中创建一个类： 1
步骤 4：网络层
在这里，您使用 Retrofit (Android) 或 Alamofire (iOS) 等库。 他们负责打开互联网连接、发送请求并等待响应等繁重工作。 处理这里的错误很重要：如果互联网出现故障怎么办？如果服务器给出错误500怎么办？
第 5 步：与 UI 连接
最后，您获取传入的数据（例如：7）并将其放置在屏幕的文本组件中（8）。
良好的日常习惯
为了避免将来出现头痛：
- 永远不要将 API 密钥放在 Git 上：如果您将私有 API 密钥上传到公共 GitHub，黑客就可以窃取它并使用您的积分。使用环境变量或9 文件。
- 处理加载：API需要时间。当数据未到达时，始终显示骨架或旋转器。
- 缓存就是生命：用户不需要每2秒下载相同的产品列表。将数据保存在本地（Room/CoreData）并仅在必要时更新。这可以节省电池和用户数据。
结论
API 是将互联网粘合在一起的粘合剂。每天与他们一起工作是一个恒定的循环：阅读文档 -> 测试 -> 代码 -> 处理错误。
掌握这个流程是将仅仅“复制屏幕”的开发人员与构建真实的互联产品的软件工程师区分开来的地方。
另请阅读
- [应用程序API - 逐步扩展10
- [应用程序API - 小型团队的一步一步11
- [应用程序API12
- [应用后端：架构、技术和最佳实践13
- [应用中的微服务：移动分布式架构14
- [REST API：它是什么以及实践步骤15