webapi是什么

你打开手机查天气，点一下按钮，数据就从远端服务器跑到了屏幕上。这个过程背后，WebAPI在干活。说白了，WebAPI就是一套约定，让两个软件隔着网络互相说话。它不像网页那样给人看，而是给程序读的。

我最早接触WebAPI是做一个天气小工具。想拿实时温度，不可能自己发射卫星，得找气象服务商。他们给一个网址，比如 https://api.weather.com/v1/current?city=beijing，我发个请求过去，它返回一段JSON：{ "temp": 23, "humidity": 45}。这个网址就是WebAPI的入口。它不返回HTML页面，而是纯粹的数据。

为什么叫“Web”API？因为走的是HTTP协议。浏览器里敲网址、点链接，用的就是HTTP。WebAPI借用这套现成的规则：用GET拿数据，用POST提交数据，用PUT更新，用DELETE删除。服务端定义好哪些URL对应哪些操作，客户端按格式发请求，剩下的就是服务器的事。比如你登录某个网站，前端把用户名密码POST到 /api/login，后端验证后返回一个token。这个 /api/login 就是一个WebAPI端点。

跟普通网页请求的区别在哪？普通网页请求返回的是给人看的HTML，里面混着样式和文字。WebAPI返回的是给程序解析的结构化数据，常见的是JSON，偶尔是XML。JSON更轻，现在基本一统天下。你打开浏览器开发者工具，看Network面板，那些类型为 fetch 或 xhr 的请求，很多就是WebAPI调用。

有人把WebAPI和库函数搞混。比如Python里的 requests.get() 是个库函数，用来发HTTP请求。而你要请求的那个远端地址，才是WebAPI。库函数是工具，WebAPI是服务。再打个比方：WebAPI像餐厅的菜单，你按菜单点菜（发请求），厨房做好端出来（返回数据）。菜单本身不是厨房，但规定了你能点什么、怎么点。

实际项目中，WebAPI的设计很讲究。URL要清晰，比如 /users/123/orders 比 /getUserOrders?uid=123 更符合REST风格。状态码也重要：200表示成功，404表示资源不存在，401表示没认证，500表示服务器内部错误。我见过一个接口，出错时也返回200，只在JSON里写 { "code": 500}。这种设计让客户端很难受，因为HTTP层看不出问题。

认证是另一个绕不开的点。公开的WebAPI谁都能调，但涉及用户数据的必须验证身份。常见方式有API Key、OAuth token、JWT。比如GitHub的API，你生成一个personal access token，请求时放在Header里：Authorization: Bearer ghp_xxx。没有这个，请求会被拒。

WebAPI不限于浏览器。手机App、桌面软件、其他服务器，只要能用HTTP，就能调。你手机上的微信，发消息时调的是腾讯的WebAPI；你用的在线文档，保存时也是调WebAPI。它把功能拆成一个个网络端点，谁需要谁调用。这种解耦让系统更灵活，前端后端可以分开开发，甚至不同团队用不同语言写。

有人觉得WebAPI很神秘，其实拆开看就是：一个URL，一种HTTP方法，一套请求格式，一套响应格式。你拿Postman或curl试几次就明白了。比如在终端敲 curl https://api.github.com/users/torvalds，立刻能看到Linus的用户信息。这就是WebAPI——简单、直接、无处不在。

很赞哦!（39646）