meteofeed v1 API 参考

v1 API 参考

meteofeed 天气 API

一个 bearer 令牌,多个权威数据源——全球范围的预报、观测、雷达、海洋、空气质量、气候、历史与地理编码。完整的机器可读契约见下方;以下是发起首次调用所需的内容。

快速开始

基础 URL

https://api.meteofeed.com/v1

所有端点均位于 /v1 下。响应为 JSON;雷达返回 PNG 瓦片。

认证

每个受保护的端点都需要 bearer 令牌。在每次请求的 Authorization 标头中发送:

Authorization: Bearer mtfd_…

密钥形如 mtfd_…,仅在创建时显示一次。请将其保存在服务器端。

套餐与速率限制

Free 每月包含 500 次请求;Basic、Pro 和 Business 将月配额提升至最高 1,000,000。每密钥的突发限制随套餐提升:Free 为每分钟 120 次请求,Basic 为 240 次,Pro 为 360 次,Business 为 600 次。超出配额或突发将返回 429 并带有 Retry-After 标头。

获取密钥

登录控制台以创建密钥。在私有预览期间,新账户通过访问申请队列进行审批。

获取 API 密钥 →

示例请求

某一点(阿姆斯特丹)的当前状况。请替换为你自己的令牌。

curl -H "Authorization: Bearer mtfd_…" \
  "https://api.meteofeed.com/v1/current?lat=52.37&lng=4.90"

本页面提供 12 种语言——请使用上方的切换器。下方的参考为英文,即 API 契约。

完整端点参考

完整的 OpenAPI 3.1 规范,实时渲染。原始规范位于 /openapi/v1.yaml。