API هواشناسی رونماهوا رایگان · بدون نیاز به کلید
یک JSON API واقعی و عمومی — بدون رجیستر، بدون کلید، بدون هزینه — برای گرفتن وضعیت فعلی هوا و پیش‌بینی روزانه از هر سایت یا اپلیکیشنی. داده از همون منبعی میاد که خود رونماهوا استفاده می‌کنه (Open-Meteo)، با همون جدول توضیح/آیکون فارسی و همون محاسبه واقعی فاز ماه.
درخواست
GET https://weather.runama.com/api/weather.php?lat={lat}&lon={lon}
یا با نام شهر به‌جای مختصات:
GET https://weather.runama.com/api/weather.php?q={نام شهر}
پارامترها
| پارامتر | الزامی؟ | توضیح |
|---|---|---|
lat, lon | یکی از این دو یا q | مختصات جغرافیایی |
q | یکی از این دو یا lat/lon | نام شهر (فارسی یا انگلیسی) — با geocoding واقعی Open-Meteo حل می‌شود |
city | خیر | نام نمایشی دلخواه وقتی lat/lon مستقیم داده می‌شود |
days | خیر (پیش‌فرض ۷) | تعداد روزهای پیش‌بینی، بین ۱ تا ۱۶ |
نمونه واقعی
این لینک واقعی است و همین الان جواب می‌دهد:
در حال دریافت نمونه پاسخ واقعی…ویژگی‌های فنی
| CORS | Access-Control-Allow-Origin: * — مستقیماً از جاوااسکریپت هر سایتی قابل‌فراخوانی است. |
| کش | هر مختصات تا ۱۰ دقیقه کش می‌شود (هدر X-Cache: HIT/MISS). |
| محدودیت نرخ | حداکثر ۳۰ درخواست در هر ۱۰ ثانیه به ازای هر IP (خطای 429 در صورت عبور). |
| خطاها | 400 پارامتر ناقص، 404 شهر یافت نشد، 502 سرویس بالادستی در دسترس نیست — همه با بدنه JSON شامل error. |
منبع داده و مجوز استفاده
داده پیش‌بینی از Open-Meteo (رایگان، بدون کلید) می‌آید. استفاده از این API رایگان و بدون محدودیت ثبت‌نام است؛ لطفاً منبع (رونماهوا) را در صورت نمایش عمومی داده ذکر کنید و از حجم غیرمتعارف درخواست خودداری کنید.