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