墨迹天气 API 接入文档moji-weather

匿名可调（每日 100 次、QPS=5）；登录后每日 30 次免费、QPS=5。

获取 API Key：登录 https://apizero.cn/account/keys

以下 5 种语言示例都是可直接运行的，只需把 YOUR_API_KEY 替换为实际 Key。

curl "https://v1.apizero.cn/api/moji-weather?city=%E5%A4%A7%E5%8C%96&id=&op=history&keyword=%E5%A4%A7%E5%8C%96&limit=&day=2026-05-12&month=202604&key=YOUR_API_KEY"

import requests

resp = requests.get(
    "https://v1.apizero.cn/api/moji-weather",
    params={
    "city": "大化",
    "id": "",
    "op": "history",
    "keyword": "大化",
    "limit": "",
    "day": "2026-05-12",
    "month": "202604",
    "key": "YOUR_API_KEY",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())

// Node.js 18+ / 浏览器原生 fetch
const params = new URLSearchParams({
  "city": "大化",
  "id": "",
  "op": "history",
  "keyword": "大化",
  "limit": "",
  "day": "2026-05-12",
  "month": "202604",
  "key": "YOUR_API_KEY",
});

const res = await fetch(`https://v1.apizero.cn/api/moji-weather?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://v1.apizero.cn/api/moji-weather", nil)
	q := req.URL.Query()
	q.Set("city", "大化")
	q.Set("id", "")
	q.Set("op", "history")
	q.Set("keyword", "大化")
	q.Set("limit", "")
	q.Set("day", "2026-05-12")
	q.Set("month", "202604")
	q.Set("key", "YOUR_API_KEY")
	req.URL.RawQuery = q.Encode()

	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

<?php
$url = "https://v1.apizero.cn/api/moji-weather?" . http_build_query([
    "city" => "大化",
    "id" => "",
    "op" => "history",
    "keyword" => "大化",
    "limit" => "",
    "day" => "2026-05-12",
    "month" => "202604",
    "key" => "YOUR_API_KEY",
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
$body = curl_exec($ch);
curl_close($ch);

$data = json_decode($body, true);
print_r($data);

{
    "code": 0,
    "msg": "成功",
    "data": {
        "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,
            "uvi": "中等",
            "sun_rise": 1778706000000,
            "sun_set": 1778757660000,
            "lunar_date": "丙午年三月廿八",
            "tips": "防暑||中午外出请注意防暑降温。"
        },
        "aqi": {
            "value": 29,
            "level": 1,
            "description": "优",
            "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,
                "condition": "多云",
                "temperature": 32,
                "humidity": 62,
                "wind_dir": "南风",
                "wind_level": "3",
                "aqi_value": 29
            }
        ],
        "index": [
            {
                "name": "限行",
                "status": "不限行"
            },
            {
                "name": "穿衣",
                "status": "炎热"
            }
        ],
        "summary": "大化瑶族自治县，多云，32℃，南风3级，空气优。",
        "_cached": false
    }
}

• 1.1.0(2026-05-15)
  • 【重大功能】新增 op=history：查过去某一天/整月的真实历史天气
  • 支持 day=YYYY-MM-DD 单日查询，自动推月份
  • 支持 month=YYYYMM 整月查询；当前月返回 1 号 ~ 昨天，历史月返回完整 30 天
  • 返回字段：当日天气描述 / 高低温 / 风向风力 / AQI；整月还含去年同期、最好/最差空气日
  • 服务端按月缓存：当前月 30 分钟、历史月 24 小时
  • 上游能查到的最早日期约今天往前 40 天
• 1.0.0(2026-05-14)
  • 首次上线
  • 支持城市名 / internal_id / 拼音 / 拼音首字母 检索
  • 实况一次返回：当前天气 + 未来 7 天 + 24 小时 + AQI + 9 项生活指数 + 气象预警 + 农历
  • 服务端 5 分钟缓存，device UID 复用