首页 / 科技 / 正文

你点的外卖,怎么从手机钻进后厨?聊聊那个叫 API 的隐形传菜员

晚上十一点,新街口那家鸭血粉丝汤还亮着灯。你瘫在沙发上,手机划两下,点了碗粉丝,加辣油,不要香菜。屏幕显示“商家已接单”。你有没有想过,这行字是怎么穿过去的?

不是魔法。中间有个跑腿的,名字很怪,叫 API。

你按“提交订单”,谁在替你传话?

你手机上的外卖 App,其实只负责“好看”和“好按”。真正知道你家地址、店铺菜单、骑手位置的,是另一台远在机房的服务器。你和它之间,隔着一堵墙。你不能直接冲进去改数据库,对吧?

于是 App 会朝服务器喊一嗓子:“这人点了鸭血粉丝汤,地址在鼓楼,赶紧安排。”服务器听见了,翻菜单、算价格、生成订单号,再回一句:“收到,预计 32 分钟。”这一来一回的规矩,就是 API。

全称叫 Application Programming Interface。翻译成人话:程序跟程序之间说话的方式。不是给人看的界面,是给代码看的菜单。

手机扫码点餐小程序调用API流程图

比如你在小程序里点单,扫桌角二维码,小程序会调用一个“获取桌号”的 API。后厨打印机“滋啦”一声,小票出来。你这边还没放下手机,师傅已经开始抓粉丝了。

这中间没有人手动转发。没人截图发微信。API 把“点单”这件事,变成了一串规定好的请求。像寄快递,地址、电话、物品,填进格子。格子不对,快递员就退回。

它更像传菜口,而不是万能插头

它更像传菜口,而不是万能插头
它更像传菜口,而不是万能插头

很多人一听“接口”,脑子里冒出一个 USB 插头。插上就能用?不太对。

USB 是物理口。API 是一套约定。更像老式饭店的传菜窗口。厨房在里面,你在外面。你不能翻窗进去炒菜。你只能把单子递到窗口,里面的人按规矩接。窗口大小、单子格式、喊号方式,全是提前定好的。

所以 API 有两面:一面是“你能问什么”,一面是“它愿意答什么”。不是所有问题都能问。

举个更近的例子。天气 App 想知道南京明天是否下雨。它不会自己去天上测。它去调用气象服务的 API:“给我新街口街道,明天上午的降雨概率。”气象服务返回一个数字:80%。天气 App 再画一把伞。

如果气象 API 只开放“当前温度”,不开放“逐小时降雨”,那天气 App 也没辙。它不能硬抢。API 边界,就是产品能力的边界。

这也解释了一个怪现象:同一个手机号,在这个 App 里能查快递,在那个 App 里查不到。不是手机不行,是对方没开那个接口。

为什么有时候点了没反应?API 在闹脾气

你肯定遇到过。点“提交”,圈圈转半天,最后弹出一句“网络开小差了”。翻译一下:App 朝 API 喊了,但没喊通,或者对方回了一句“我听不懂”。

常见状况有好几种。

一种是请求没送到。地铁里信号断了,API 根本收不到。就像你对着传菜窗口喊,但窗口关着。

一种是送错了。App 把“桌号 8”写成了“桌号八”。API 说:格式不对,返回 400。你看到的是“参数错误”,或者更粗暴的“系统繁忙”。

还有一种是对方忙炸了。双十一零点,订单像潮水。服务器处理不过来,API 返回 500。你这边看到“稍后再试”。其实不是你的手机烂,是那头的厨房锅烧红了。

以及,最常见的一种:身份过期。你登录后拿到一张临时通行证,叫 token。它有时效。过期了,API 就不认你。你感觉“怎么突然要重新登录”,不是 App 抽风,是通行证到期了。

外卖平台订单API接口数据流转示意图
外卖平台订单API接口数据流转示意图

说个我自己的事。有次在河西一家小馆子,扫码点餐,页面死活加载不出菜单。服务员说“你连下 WiFi”。我连了,还是不行。后来发现,他们家的点餐小程序调用的是总部的菜单 API。那天总部机房网络抖了一下。店里 WiFi 好得很,没用。

你看,API 不在你手里。它在你看不见的那一段路上。

你每天都在调用 API,只是没意识到

你每天都在调用 API,只是没意识到
你每天都在调用 API,只是没意识到

早上刷地铁码。闸机“滴”一声。背后是地铁系统调用某个 API,验证你的乘车码。你手机上的二维码,只是一个凭证。

中午用微信登录某个小游戏。弹窗问“是否允许获取昵称头像”。你点“允许”。微信通过 API 把一段加密信息递给游戏服务器。游戏不用知道你的密码,也能认出你。

晚上把照片存进网盘。进度条走完。客户端调用存储 API,把照片切成块,一块块塞进去。你看到的“上传成功”,其实是 API 回了一句“我收到了”。

甚至你打开这篇文章所在的页面,浏览器也在调用 API。只不过有些 API 是网页接口,返回 HTML;有些返回 JSON 数据,再由前端拼成你看到的画面。

有意思的是,API 越稳定,你越感觉不到它存在。像自来水。龙头一拧,水就来。哪天停水,你才会骂骂咧咧地找原因。API 也一样。它好的时候,没人夸。它一挂,全网哀嚎。

那,知道 API 有什么用?

倒不是让你去写代码。普通人有普通人的用法。

比如,下次看到“授权登录”,你会多看一眼:它在要什么权限?是只要头像昵称,还是还想读你的好友列表?API 能拿多少,取决于你点了哪个“允许”。

再比如,听到“我们开放了 API”,你可以理解成:这家公司把自家的一部分能力,做成了传菜窗口。别人可以按规矩来取。小团队不用重新造轮子,就能做出新东西。地图、支付、短信验证码,都是这么被接进各种 App 的。

当然,也有另一面。API 开得太大,又没做好门禁,就可能被乱调用。你偶尔接到奇怪的验证码短信,背后可能是有人拿短信 API 在试。好在正规平台会限流、会鉴权、会盯着异常。这场猫鼠游戏,一直在后台跑。

所以,API 不是什么高冷缩写。它是互联网的传菜口。你点的每一单、刷的每一次码、存的每一张图,都得从那个小窗口递过去。窗口后面的人看不见,但忙得很。

下次外卖迟到,先别急着怪骑手。也可能是某个 API,正在路上喘气。