跳到主要内容

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. 授权身份认证

👇文档问题反馈​