RestApi与GraphQL的区别解析及天气API选型困惑：为何用GraphQL/Webhook

核心区别对比 #

• 数据获取方式：
  • Rest：每个端点返回固定结构的完整数据，哪怕你只需要其中几个字段，也会拿到全部内容（比如请求天气接口，可能返回温度、湿度、气压、风向等所有关联字段）。
  • GraphQL：你可以精准定义需要的字段，服务器仅返回你指定的数据，彻底避免冗余传输。
• 请求次数：
  • Rest：获取关联数据可能需要多次请求（比如先查城市天气，再查该城市空气质量，得调用两个不同端点）。
  • GraphQL：一次请求就能获取所有需要的关联数据，大幅减少网络交互次数。
• 接口维护成本：
  • Rest：新增功能需求往往需要新增端点，随着业务扩展，端点数量会持续增长，管理成本上升。
  • GraphQL：仅需一个入口端点，通过调整查询字段就能适配新需求，无需频繁新增接口。

天气API调用示例 #

Rest API 示例（获取城市天气） #

假设使用某天气服务商的Rest接口：

# GET 请求
curl "https://api.weather-service.com/v1/city/Beijing?appkey=YOUR_KEY"

返回响应会包含所有预设字段，示例如下：

{
  "coord": { "lon": 116.3972, "lat": 39.9075 },
  "weather": [{ "main": "Clouds", "description": "broken clouds" }],
  "main": { "temp": 22.5, "feels_like": 21.8, "humidity": 65, "pressure": 1013 },
  "wind": { "speed": 3.09, "deg": 100 },
  // 其他未用到的冗余字段...
}

GraphQL 示例（获取指定天气字段） #

假设使用支持GraphQL的天气API：

# POST 请求，请求体为GraphQL查询语句
curl -X POST "https://api.weather-service.com/graphql" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query GetCityWeather($city: String!) { weather(city: $city) { temp humidity description } }",
    "variables": { "city": "Beijing" }
  }'

返回响应仅包含你指定的字段：

{
  "data": {
    "weather": {
      "temp": 22.5,
      "humidity": 65,
      "description": "broken clouds"
    }
  }
}

为什么还要用GraphQL/Webhook？ #

关于GraphQL #

• 适配低带宽场景：如果你的应用运行在移动端或网络条件较差的环境，GraphQL减少的冗余数据能显著提升加载速度。
• 快速响应需求变化：后续如果需要新增获取风向、气压等字段，只需修改前端查询语句，无需后端调整接口，迭代效率更高。
• 统一数据入口：复杂应用中，多个模块的数据源可以通过一个GraphQL接口聚合，避免管理大量分散的Rest端点。

关于Webhook #

Webhook和Rest/GraphQL的定位完全不同：

• Rest/GraphQL是主动拉取数据，需要你定时或按需调用接口获取天气信息。
• Webhook是被动接收数据，当天气触发指定条件（比如气温骤降10℃、发布暴雨预警），服务器会主动把数据推送到你配置的地址。
• 适合需要实时响应天气变化的场景，比如智能设备联动、预警通知服务，无需频繁轮询接口，能节省大量资源。

内容的提问来源于stack exchange，提问作者Hamza Saghir