
一起动脑筋 · 先看一个小故事
女孩到窗口点餐,不需要钻进厨房。机器人说,程序也可以通过约定的接口请求功能。
把过程摊开来看
- 约定输入要什么、带哪些参数
- 调用接口按格式提交
- 执行功能内部处理
- 约定输出结果或错误
API 是程序使用另一部分功能的接口约定。
像菜单告诉你可点什么、需要提供什么信息、会得到什么结果。网络 API 常通过请求与响应工作,但 API 也可以存在于同一个程序或库里。
清楚的接口让使用者不必了解全部内部实现。
轮到你来试一试
接口要求城市编号,你却提交一张图片,服务一定能猜你想查天气吗?
想好了吗?点开看解释
不能依赖猜测。调用方要遵守输入格式,服务端也应检查并返回适当错误。
带走一个发现
API 是程序使用另一部分功能的接口约定。
试着遮住上面的图,把每一步讲给家人听。如果某一步说不清楚,就回到那张卡片再看一遍。