MiniCode

API

应用程序接口

免费阅读 · 更新于

一句话理解

理解一个程序怎样使用另一个程序的能力。

打个比方

餐厅的菜单告诉你能点什么、需要说明哪些要求。你按菜单下单,不必进入厨房操作每件设备。API 也会规定可用的能力和使用方式。

API 是程序之间约定好的接口。它不一定经过网络;浏览器也提供读取位置等 API。学习 AI 编程时,常见的是通过网络请求调用模型、天气或其他服务。

看个例子

通信示意 · 非真实接口
请求:GET /api/weather?city=杭州

响应:
{ "city": "杭州", "temperature": 26 }

这个虚构接口用来说明:调用方提交城市,服务返回结构化数据。真实地址、参数和权限需要查服务文档。

什么时候会遇到

  • 让聊天页面连接模型服务。
  • 从服务端读取商品、天气或文章等数据。

常见误解

有 API 地址不等于可以直接使用。调用可能需要身份验证、权限和额度,也可能失败。

想一想

拿到一份 API 文档,先找哪些信息?

查看答案

先找请求地址、请求方法、输入参数、认证方式和响应示例,再看错误说明。不要只复制地址就假设已经接通。

继续查阅官方资料

MDN · API本文为面向新手的概念解释,具体工具行为以对应文档为准。