POST AI agent ready /v1/weather/current

天气 API - 按城市或坐标列出的当前状况

返回由城市名称或纬度/经度指定的位置的当前天气数据。响应包括温度（感觉类似）、湿度、降水量、风速和风向、云量、数字天气代码和人类可读的描述。

Endpoint

curl -X POST https://api.botoi.com/v1/weather/current \
  -H "Content-Type: application/json" \
  -d '{"city":"London","lat":51.5074,"lng":-0.1278}'

When to use this API

根据访问者当地的天气个性化主页横幅或产品推荐。零售网站可以在下雨时推销雨伞，或在晴朗的天空中推销防晒霜，从而提高与上下文相关的转化率。

在派遣司机之前检查送货路线沿线的天气状况。标记有大风或强降水的路线，以便调度员可以改变路线或延迟发货，以保护货物和驾驶员的安全。

轮询当前天气数据以触发智能家居操作。当云量低于 20% 时关闭电动百叶窗，仅在降水量为零时启动喷水器，或根据感觉温度调整恒温器设定点。

我应该使用城市名称还是坐标？

要么有效。城市名称方便面向用户的输入。当多个城市同名时，坐标会更加精确并避免歧义（例如，“斯普林菲尔德”存在于美国 30 多个州）。

返回什么温度单位？

默认情况下，返回的温度以摄氏度为单位。响应中的单位字段证实了这一点。使用公式 F = C * 9/5 + 32 转换为客户端华氏度。

天气数据多久更新一次？

上游来源的天气数据每 15 分钟刷新一次。对于大多数应用程序来说，将响应缓存 10-15 分钟是安全的，并且可以减少 API 调用。

Weather_code字段代表什么？

Weather_code 是 WMO 天气解释数字代码。常用值：0 = 晴天，1-3 = 晴间多云，45/48 = 有雾，51-67 = 毛毛雨/雨，71-77 = 雪，80-82 = 阵雨，95+ = 雷暴。描述字段提供人类可读的标签。

如果既没有提供城市也没有提供坐标会发生什么？

端点返回错误，要求您提供城市名称或纬度/经度对。至少需要一个位置参数。

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.