尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
墨迹天气 API 最小可运行示例:实况、预报与生活指数一次搞定
适用场景与接口定位墨迹天气 API 面向需要实时或历史天气数据的应用场景例如智能家居面板、户外活动提醒、农业辅助决策非专业级、个人天气助手等。它一次调用即可返回实况、未来 7 天逐日预报、24 小时逐时趋势、AQI、9 项生活指数、气象预警及农历信息极大减少客户端对接口的并发请求次数。接口能力边界能力项说明城市覆盖全国 3 万 城市及区县查询模式城市名模糊city、城市 ID 直查id、城市搜索opsearch、历史天气ophistory实况数据温度、体感温度、天气现象、湿度、气压、紫外线、风向风力等预报数据未来 7 天逐日预报含 AQI、24 小时逐时预报生活指数穿衣、限行、防晒、运动等 9 项指数历史天气支持单日或整月查询范围当前月到过去几个月建议 40 天内QPS 限制5 请求/秒缓存策略实况 5 分钟当月历史 30 分钟历史月 24 小时数据说明由墨迹天气提供仅供参考不可用于农业、保险、航运、防灾等专业决策请求参数与鉴权接口地址https://v1.apizero.cn/api/moji-weather请求方法GETQuery 参数详解参数必填类型说明示例city否与 id 二选一string城市中文名支持模糊匹配匹配第一个结果大化id否与 city 二选一number城市 internal_id通过 opsearch 获取直查更快1205op否string查询模式空实况search搜索城市history历史天气historykeyword否string当 opsearch 时必填支持中文、拼音、拼音首字母大化limit否number当 opsearch 时生效返回条数 1-50默认 205day否string当 ophistory 时必填单日查询格式 YYYY-MM-DD 或 MM-DD配合 month2026-05-12month否string当 ophistory 时可选整月查询格式 YYYYMM202604Header 鉴权需要在 HTTP Header 中携带 API KeyX-API-Key: your_api_key 若未提供 API Key服务端可能会返回 401 或限制访问。实际使用时请在 apizero.cn 准备获取。最小可运行示例Curl 命令以下三个示例覆盖最主要的使用场景你可以直接复制到终端运行替换$APIZERO_API_KEY为你的真实 Key。1. 按城市名查实况curl -sS -X GET \ -H X-API-Key: $APIZERO_API_KEY \ https://v1.apizero.cn/api/moji-weather?city杭州返回当前杭州的实况天气、AQI、逐时预报、未来 7 天、生活指数等所有数据。2. 先搜索城市 ID再直查更高效# 第一步搜索“大化”拿到 id curl -sS -X GET \ -H X-API-Key: $APIZERO_API_KEY \ https://v1.apizero.cn/api/moji-weather?opsearchkeyword大化limit3 # 第二步用 id1205 直查跳过模糊匹配响应更快 curl -sS -X GET \ -H X-API-Key: $APIZERO_API_KEY \ https://v1.apizero.cn/api/moji-weather?id12053. 查询历史天气单日curl -sS -X GET \ -H X-API-Key: $APIZERO_API_KEY \ https://v1.apizero.cn/api/moji-weather?ophistorycity北京day2026-05-12注意历史数据范围受缓存策略影响。当月数据可查询到昨天历史月份可查询完整月。建议查询 40 天以内的日期更早月份可能无数据。响应结构与字段解读成功响应为 JSON 格式外层code为 0 表示成功data包含所有天气信息。以下拆解核心字段{ code: 0, msg: 成功, data: { _cached: false, city: { id: 1205, name: 大化瑶族自治县, parent: 广西壮族自治区, pinyin: dahuayaozuzizhixian, timezone: 8 }, condition: { condition: 多云, temperature: 32, real_feel: 36, humidity: 62, pressure: 999, wind_dir: 南风, wind_level: 3, sun_rise: 1778706000000, sun_set: 1778757660000, lunar_date: 丙午年三月廿八, tips: 防暑||中午外出请注意防暑降温。, uvi: 中等 }, aqi: { value: 29, description: 优, level: 1, updatetime: 1778756400000 }, forecast_day: [ { predict_date: 1778601630000, condition_day: 多云, condition_night: 多云, temp_day: 32, temp_night: 21, wind_dir_day: 南风, wind_level_day: 3, aqi_value: 29, aqi_desc: 优 } ], forecast_hour: [ { predict_hour: 1778752800000, temperature: 32, condition: 多云, humidity: 62, wind_dir: 南风, wind_level: 3, aqi_value: 29 } ], index: [ { name: 限行, status: 不限行 }, { name: 穿衣, status: 炎热 }, { name: 紫外线, status: 中等 } // ... 共 9 项 ], summary: 大化瑶族自治县多云32℃南风3级空气优。 } }字段要点说明condition中的temperature为当前温度℃real_feel为体感温度。时间戳均为 Unix 毫秒UTC8如sun_rise: 1778706000000对应 2026‑05‑12 06:00:00 CST。forecast_day数组长度固定为 7未来 7 天forecast_hour为 24 个条目。aqi的updatetime是 AQI 的更新时间戳不为实时数据。index数组具体项目与数量可能随城市和季节变化建议代码中做动态渲染。当查询ophistory时返回结构略有不同data下会多出history字段包含date、condition等历史数据。实际响应结构以官方文档为准。常见错误与排查错误表现可能原因排查方案HTTP 401Header 中未传或传错X-API-Key检查 Key 是否正确是否已过期HTTP 400必填参数缺失或格式错误如day不是有效日期对照 Query 参数表检查必填项和格式code ≠ 0 且 msg 含“城市不可识别”城市名不在数据库中或拼音不完全匹配先用opsearch找到准确的城市名和 id历史查询返回空数据日期太早超出记录范围或查询未来日期仅查询过去 40 天内的有效日期QPS 超限每秒请求超过 5 次添加本地限流或重试策略减少并发返回_cached: true走服务端缓存数据可能滞后根据业务容忍度决定是否强制刷新当前不支持主动清除缓存工程化注意事项优先使用 city_id 直查城市搜索返回的id是稳定的数值标识用id参数查询可避开模糊匹配的耗时并减少重复计算。建议在本地建立城市ID映射表。合理使用缓存实况数据缓存 5 分钟历史月数据缓存 24 小时。如果业务需要更实时可缩短轮询间隔但不宜低于 5 分钟。异常重试策略对于网络波动或临时限流建议指数退避重试如 1s、2s、4s最多 3 次。避免重试时冲爆 QPS。数据准确性说明接口数据仅供一般参考不应直接用于专业决策。如果需要用于农业灌溉、保险理赔、航运调度等场景请务必与官方气象局数据交叉验证。timezone 字段city.timezone为 UTC 偏移小时数中国为 8若用户终端与北京时间不同需做时区转换。农历和 tips 处理condition.tips为字符串用||分隔标题与内容建议解析为结构化显示。JSON 解析时注意字段类型wind_level在 forecast_hour 中是字符串3在其他位置可能是数字3需统一处理。参考文档官方文档https://apizero.cn/aidocs/moji-weather原始 Markdownhttps://apizero.cn/aidocs/moji-weather/raw.md接口调试地址https://v1.apizero.cn/api/moji-weather需携带 API Key
RELATED

相关推荐

从Arduino到PCB:创客硬件开发的四个阶段与实战心法

从Arduino到PCB:创客硬件开发的四个阶段与实战心法

1. 项目概述:一封写给创客的信,究竟在说什么?最近在整理工作室的旧物,翻出了几块布满灰尘的开发板和一堆半成品的原型机。看着它们,我突然意识到,从第一次点亮LED,到做出能拿出手的产品&#xf…

📅 2026/11/20 21:54:19
Minerva深度学习框架入门:如何用类NumPy接口快速构建GPU加速模型

Minerva深度学习框架入门:如何用类NumPy接口快速构建GPU加速模型

Minerva深度学习框架入门:如何用类NumPy接口快速构建GPU加速模型 【免费下载链接】minerva Minerva: a fast and flexible tool for deep learning on multi-GPU. It provides ndarray programming interface, just like Numpy. Python bindings and C bindings are…

📅 2026/9/17 14:25:13
VisualRust开发指南:贡献代码前必须了解的项目架构与组件

VisualRust开发指南:贡献代码前必须了解的项目架构与组件

VisualRust开发指南:贡献代码前必须了解的项目架构与组件 【免费下载链接】VisualRust Visual Studio extension for Rust 项目地址: https://gitcode.com/gh_mirrors/vi/VisualRust VisualRust是一款为Visual Studio提供Rust语言支持的扩展工具,…

📅 2026/11/3 18:47:42
MORE NEWS

更多资讯

📰

电工证学历证明怎么开?考前押题攻略帮你快速拿证

电工证学历证明怎么开?考前押题攻略帮你快速拿证 你是不是还在为电工证学历证明怎么开而发愁?找工作被卡在第一关,特种作业证没拿到,连面试机会都没得谈。现在电工证是很多岗位的硬性门槛,尤其在建筑、电力、制造业等行业,没有电工证,连入职资格都没有…

📰

特种工操作证挂靠通过率揭秘:考不过真的白交钱?

特种工操作证挂靠通过率揭秘:考不过真的白交钱? 怕考不过白交培训费?特种工操作证挂靠确实是一门技术活,尤其是对于鹤壁劳务班组负责人来说,选对培训机构、掌握复审流程、了解挂靠政策,直接影响到项目的顺利推进。很多人花了钱却没拿到证,甚至证书信息…

📰

地方电工证在哪里办理通过率揭秘:许昌电工实操考试避坑全攻略

地方电工证在哪里办理通过率揭秘:许昌电工实操考试避坑全攻略 你是不是也像我一样,一想到电工实操考试就紧张得睡不着觉?怕操作不当,怕流程不熟,更怕一不小心挂科耽误工作?其实很多人报考电工证,心里最怕的就是实操考试这一关, 通过率揭秘…

📰

电工证成绩怎么分abcde 2026河南最新政策怎么考

电工证成绩怎么分abcde 2026河南最新政策怎么考 实操考试心里没底怕挂科,这事儿谁没经历过?特别是在南阳卧龙区从事市政公用工程的朋友,很多都面临一个头疼的问题:电工证成绩怎么分abcde?这直接关系到能不能顺利拿证,能不能在项目上正常…

📰

公司电工作业是咋样的特种作业证含金量到底高不高

公司电工作业是咋样的特种作业证含金量到底高不高 证书过期了不知道怎么复审延期,别慌,先搞清楚你的特种作业证到底有没有含金量。如果你是三门峡房建工程从业者,又或者是正在准备考电工证的人员,这些问题你必须知道:公司电工作业是咋样的?特种作业证到…

📰

汝州市安监局电工证上岗必备:考不过白交钱?一文看懂怎么避坑

汝州市安监局电工证上岗必备:考不过白交钱?一文看懂怎么避坑 怕考不过白交培训费?别急,先搞清楚【汝州市安监局电工证】到底值不值得花这笔钱。现在各行各业都讲“持证上岗”,尤其是像电工这样的高危岗位,没有证连门都进不去。本文从真实案例、政策变化…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬