API 是什么

API 是什么？不用写代码也能先理解这个概念

API 经常出现在开发文档里，但它并不神秘。可以先把它理解成：两个软件之间约定好的沟通方式。

请求和响应

一方按照约定发送请求，另一方返回数据或执行操作。至于请求里要带什么、返回什么格式，就由 API 文档规定。

如果每个系统都要直接操作对方内部代码，协作会非常混乱。API 把可用能力整理成边界清楚的接口。

很多服务用 API Key 标识调用方。它通常应该保存在安全位置，不要直接写进公开网页或提交到公开代码仓库。

通常会写明地址、请求方法、参数、认证方式、返回结构和可能出现的错误。调用失败时，先检查是否按文档发送了正确字段，比不断改代码碰碰运气更有效。

同一个服务可能同时提供网页、手机应用和 API；API 是给程序之间使用的接口，不是另一个“隐藏网页”。

知道 API 的基本含义后，可以从API 调试与开发工具了解怎样发送请求、查看返回结果。练习时不要把真实的访问密钥贴进公开网页或分享截图。

先找到接口文档中的请求地址和方法，再确认身份验证方式、必填参数和返回示例。测试时使用最小可行请求，检查响应状态与错误信息，避免一开始就接入完整业务。密钥不要写进公开网页或提交到公开代码仓库，涉及用户数据时还应核对服务的数据处理规则。

理解接口概念后，可以查看API 开发与调试工具，再决定从文档阅读还是接口请求测试入手。