API基础知识

---

适读对象为无代码基础的读者，本文结合工作流中的发送API请求，简单介绍API接口的一些基础知识。

API 简明指南

什么是API？

API（Application Programming Interface，应用程序接口）就像餐厅的服务员：

• 您不需要知道厨房如何做菜（内部实现）
• 只需按菜单点餐（发送请求）
• 就能得到想要的食物（获取结果）

实际案例：全国常用电话

试试这个查询服务： https://apis.tianapi.com/dailytel/index?key=118c67af4f1c8bf36df3a77cdacbc327&word=京东商城

使用方法：

1. 访问上述链接
2. 将"京东商城"替换成你想查询的全国常见电商、物流、学校、政府、金融名称
3. 按回车键获取结果

API的特点

1. 黑箱操作：使用者无需了解内部实现
2. 标准化访问：按照固定格式请求即可
3. 即用即得：发送请求后立即获得响应
4. 功能复用：可以反复调用相同功能

为什么使用API？

• 节省开发时间（不用重复造轮子）
• 降低技术门槛（非技术人员也能使用）
• 提高开发效率（专注业务逻辑而非底层实现）

常见API类型

类型	示例	特点
数据API	天气查询	返回结构化数据
功能API	支付接口	执行特定操作
服务API	地图服务	提供完整功能

提示：使用时请遵守各API的服务条款和调用限制。

API请求的组成

什么是请求，API接口的调用，是通过一个URL地址传输的，URL打开一次就是一次请求，刷新页面，又算一次请求。
请求API接口，其实就是打开访问接口的URL，此URL在请求时需要几个组成部分：

• API接口地址
  即API接口服务公开给外部访问的地址
• 请求方式
  常用的有Get、Post和其他方式，这取决于API接口服务，无需理解。他们支持什么，我们选择对应的方式即可。
• 请求的参数
  API接口根据你传递的参数处理对应的数据。例如，URL中的phone就是一个参数
• 授权认证方式
  在请求API时，不是准请求都会处理，需要对您的请求做认证。常见的是token认证和key(有时还有会结合sign)。这些信息API服务商都会给到您。
• Header
  请求过程中需要传递的表头信息，是系统级的参数，包含存储认证信息Token的参数。一般情况下我们不需要配置，需要配置时，API文档中会特别说明。
• Body
  同样也是存储传递的数据，它在请求方式为Post时才需要配置。常用来存储表单信息，有时授权认证的参数也可以存储在这里。
  
  例如，通过API接口，将一个表单数据新增到第三方系统，表单的字段名称和字段值存放在Body中。

总体来说：调用API接口时，需要三部分：

1. 请求的API URL地址
2. 传递的参数
3. 授权身份认证