IP天气查询接口-天气预报api即可-天气查询接口-追梦API

IP天气查询

/api/v1/iptq 0.02 积分/次（约 ¥0.001/次）运行中

天气预报-天气查询-全国天气预报

请求示例

request

CURL Python Node.js

curl -X POST https://api.zhuimengapi.com/api/v1/iptq \
  -H "X-API-Key: RPA-xxxxxxxx"
  -d "ip=your_ip"

import requests

url = "https://api.zhuimengapi.com/api/v1/iptq"
headers = {"X-API-Key": "RPA-xxxxxxxx"}
data = {
  "ip": "your_ip"
}

res = requests.post(url, data=data, headers=headers)
print(res.json())

const axios = require('axios');

axios.post("https://api.zhuimengapi.com/api/v1/iptq", {
    ip: "your_ip"
}, {
  headers: { "X-API-Key": "RPA-xxxxxxxx" }
}).then(res => console.log(res.data));

响应示例

response.json

{
    "code": 0,
    "msg": "code对应的描述",
    "taskNo": "本次请求号",
    "data": {
        "area": "IP所在地区",
        "areaId": "地名id，详见地名说明",
        "province": "省份",
        "city": "城市",
        "now": {},
        "dayWeathers": []
    },
    "data.now.sd": "湿度",
    "data.now.aqi": "空气质量",
    "data.now.weather": "天气",
    "data.now.weather_pic": "天气图标",
    "data.now.temperature": "温度",
    "data.now.wind_direction": "风向",
    "data.now.wind_power": "风级",
    "data.dayWeathers.daytime": "日期",
    "data.dayWeathers.day_weather": "白天天气",
    "data.dayWeathers.day_weather_code": "白天天气编号，详见天气编号",
    "data.dayWeathers.day_weather_pic": "白天天气图标",
    "data.dayWeathers.day_high_temperature": "白天最高温度",
    "data.dayWeathers.day_wind_direction": "白天风向",
    "data.dayWeathers.day_wind_power": "白天风级",
    "data.dayWeathers.night_weather": "夜间天气",
    "data.dayWeathers.night_weather_code": "夜间天气编号",
    "data.dayWeathers.night_weather_pic": "夜间天气图标",
    "data.dayWeathers.night_low_temperature": "夜间最低温度",
    "data.dayWeathers.night_wind_direction": "夜间风向",
    "data.dayWeathers.night_wind_power": "夜间风级"
}

接口信息

请求地址 https://api.zhuimengapi.com/api/v1/iptq

请求方式 POST

Content-Type application/x-www-form-urlencoded

鉴权方式 X-API-Key: RPA-xxxxxxxx

请求参数

ip string 必填

IP地址

返回字段

code int 必填

状态码，详见code返回码说明

msg string 必填

code对应的描述

taskNo string 必填

本次请求号

data object 必填

返回数据

area string 必填

IP所在地区

areaId string 必填

地名id，详见地名说明

province string 必填

省份

city string 必填

城市

now object 必填

当前实时天气

dayWeathers array 必填

未来7天天气，按日期从早到晚排序

data.now.sd string 必填

湿度

data.now.aqi string 必填

空气质量

data.now.weather string 必填

天气

data.now.weather_pic string 必填

天气图标

data.now.temperature string 必填

温度

data.now.wind_direction string 必填

风向

data.now.wind_power string 必填

风级

data.dayWeathers.daytime string 必填

日期

data.dayWeathers.day_weather string 必填

白天天气

data.dayWeathers.day_weather_code string 必填

白天天气编号，详见天气编号

data.dayWeathers.day_weather_pic string 必填

白天天气图标

data.dayWeathers.day_high_temperature string 必填

白天最高温度

data.dayWeathers.day_wind_direction string 必填

白天风向

data.dayWeathers.day_wind_power string 必填

白天风级

data.dayWeathers.night_weather string 必填

夜间天气

data.dayWeathers.night_weather_code string 必填

夜间天气编号

data.dayWeathers.night_weather_pic string 必填

夜间天气图标

data.dayWeathers.night_low_temperature string 必填

夜间最低温度

data.dayWeathers.night_wind_direction string 必填

夜间风向

data.dayWeathers.night_wind_power string 必填

夜间风级

响应状态说明

不同接口的成功返回字段可能不同，请以本接口的响应示例和实际结果为准。请求失败时使用下方统一错误结构，失败调用不计费。

200 请求成功返回字段以本接口的响应示例和实际结果为准，部分接口不包含 code 字段。按接口规则计费
400 参数或业务错误请求参数无效时返回安全、明确的修正提示。不扣费
401 API Key 无效密钥缺失、格式错误、无效或已经过期。不扣费
402 账户余额不足请充值后重试；本次请求不会进入接口处理。不扣费
403 访问被拒绝IP 规则限制，或当前账户无权调用仅限 VIP 的接口。不扣费
404 接口路由不存在请检查请求地址中的 API 路由是否正确。不扣费
405 请求方法不支持请按照接口文档使用允许的 GET 或 POST 方法，并查看 Allow 响应头。不扣费
413 请求体过大单次请求最大允许 20MB。不扣费
429 请求频率超限请根据 Retry-After 响应头稍后重试。不扣费
500 系统服务异常请稍后重试；持续出现时请向技术支持提供 request_id。不扣费
502 接口服务暂时不可用接口处理异常或暂时不可用，请稍后重试。不扣费
503 系统服务暂时不可用服务正在恢复，请稍后重试。不扣费

错误响应示例使用 request_id 查询对应调用日志

{
  "code": 400,
  "message": "请输入有效的身份证号码",
  "data": null,
  "request_id": "1-xxxxxxxx",
  "time": "2026-07-29 12:00:00"
}

请求地址 https://api.zhuimengapi.com/api/v1/iptq

请求方式 POST

Content-Type application/x-www-form-urlencoded

鉴权 Header X-API-Key

API Key

Params Body

Params GET 请求只通过 URL 查询参数发送

Body 表单模式 POST + application/x-www-form-urlencoded 使用表单键值对请求体

快速信息

接口路由	`iptq`
接口分类	-
请求方式	POST
计费方式	0.02 积分/次（约 ¥0.001/次）
频率限制	50 次/秒
认证方式	`X-API-Key`
接口提供	官方接口

如何调用

注册/登录本站账号
前往用户中心 → API密钥，创建一个密钥
在请求头添加 X-API-Key 携带密钥即可调用
每次成功调用将扣除 0.02 积分

前往创建 API 密钥