Ошибка 401 openweathermap

OpenWeather (headquartered in London) is a team of IT-intellectuals that create pivotal products for business using climate data. For each point on the globe, OpenWeather provides hyperlocal minutely forecast, historical data, current state, and from short-term to annual forecasted weather data. All data is available via industry standard APIs.

OpenWeather Ltd. has more than 3 million customers including Fortune 500 companies and thousands of other businesses globally.

In order to use our services, you need to get and use your personal API key in all your API requests. How to do it:

1. Sign up and get an API key (APPID) on your account page.
2. Verify your email address via a confirmation letter that will be sent to you.
3. After verification, check your Inbox again to find our welcome email that contains your API key and important information.

Congratulations! Now you have a Free OpenWeather account and can start using our services. We highly recommend you to read the API documentation that explains how to use our APIs.

For each point on the globe, OpenWeather provides hyperlocal minutely forecast, historical data, current state, and from short-term to annual and forecasted weather data. All data is available via industry standard APIs.

One Call API by call:

Make just one API call and get all your essential weather data for a specific location with One Call API 3.0.

• Current weather
• Minute forecast for 1 hour
• Hourly forecast for 48 hours
• Daily forecast for 7 days
• National weather alerts
• Historical weather data for 40+ years back

For more functionality, please consider our generous professional subscriptions.

Professional collections:

Current Weather and Forecasts Collection

How to get:

• APIs (you can request data for geographic coordinates, ZIP codes, city name, city ID, number of cities)
• Bulk Download (download already collected and regularly updated data for a list of global locations; available for premium subscriptions)

Historical Weather Collection

How to get:

• On-the-fly bulks for customised lists of coordinates
• Marketplace of prepared data sets (coordinates, cities, zip codes) — History Bulk (40+ years back), History Forecast Bulk (from 7 Oct 2017)
• APIs to a timestamp / a period (subscriptions with different limits on calls and depth of archive)

Specialised products:

• Solar Radiation API
• Global Weather Alerts
• Road Risk API
• Global Precipitation Maps — Forecast and historical data
• Weather Maps 2.0 with 1-hour step

Detailed information about all our products can be found on the Pricing page.

To authorise a request from you and process it, we require you to use your unique API key in each API call.

In order to do this, add your API key as an appid parameter to the GET request, like in the following example:

api.openweathermap.org/data/2.5/weather?id=524901&appid=YOUR_API_KEY

Just use your API key instead of “YOUR_API_KEY” with your personal API key, it can be found in your personal account on the “API keys” page. You can also create additional API keys there.

You can create as many keys as you like. The total number of API calls for your account is counted based on all of your API keys together — please note this when choosing a subscription as they have various limits on API calls that can be made per day/per minute.

More information about subscription limits can be found on the Pricing page.

You can delete unnecessary API keys but please note that your account with us should have at least 1 API key at any time.

To find your API key, go to your personal account and click the “API keys” tab

When you have more than 1 registered API key, there will be an option to delete an API key.

The «One Call by Call» subscription is a subscription that includes only one product, but allows you to pay only for the number of API calls made to this product. One Call API 3.0 contains the following data in an API response:

• Minute forecast for 1 hour
• Hourly forecast for 48 hours
• Daily forecast for 8 days
• Historical data for 40+ years back by timestamp
• National weather alerts

If you want to learn more about One Call API 3.0, please follow the link.

If you are ready to subscribe to the «One Call by call subscription», please refer to the Pricing page.

Our system sums up the number of calls that were in excess of the free limit (1,000 calls per day). You will be automatically charged at the end of your subscription months.

If you unsubscribe before the end of your subscription month, then you will be charged at the time of unsubscribing.

You can make 1,000 API calls per day for free.

However, you should put your payment details when you subscribe to this plan.

Once you subscribe to this plan, 2,000 API calls per day are set up by default.
If you want to change this limit, please go to the «Billing plans» tab in your Personal account to update standard settings. Please see the screen below:

You can recieve «429» error in only one case — if you make the number of calls that exceeds the set limit of calls per day or per month.

Please note that the limit 2,000 API calls per day is set by default. You can always change this limit on the «Billing plans» tab. Please see the screen below:

The Professional API collections include several products in each subscription plan. Unlike the «One Call by Call» subscription, professional subscriptions have a fix price per month and API call limits (number of API calls per minute and number of API calls per month).

The Professional API collections contain access to weather historical data, current and various forecasts. These collections also allow users to request weather maps and get weather data not only via API, but with other instruments.

The structure of our Pricing is quite simple.

The Current Weather and Forecasts Collection provides access to a range of products such as current weather, forecasts, short-term historical data, weather maps and other products.

We provide a completely Free plan. If its functionality is not enough for the size of your applications, we suggest a variety of subscriptions with ability to call APIs more intensively, higher availability of service (up to 99.9%) and premium level of support.

The Historical Weather Collection provides access to up 40 years’ worth of detailed historical weather data for any location. You can request data via APIs or by a one-time export of historical data for a list of locations.

If you need an advice on choosing the correct subscription, please contact our team for assistance.

The number of API calls you are allowed to make depends on the subscription you choose.

For any professional subscription you should to maintain your usage below both per-minute and per-month limits.

For Free plan

We will notify you and ask you to either migrate to a subscription plan that meets your needs or reduce a number of API calls accordingly. We expect you to take one or another action to avoid suspending of your account.

For users with paid plans

We always contact you to find a suitable solution for you.

For monthly recurring payments

You will be charged a fixed monthly fee based on the subscription plan you select on the “Pricing” page. In this case, the fee will be taken from your payment card. In your first month, you will be charged immediately after subscribing. The next payment will be a month later, and so on. The fee is subject to change, but we always notify you beforehand.

You can subscribe here.

For long-term subscriptions via manual invoicing

In case of manual invoicing, the payment process is discussed personally with each customer.

If you want to set up a long-term subscription, please contact our support team.

If you would like to unsubscribe, please log in to your account on our website, then use the “Unsubscribe” button opposite your active plan in your personal account. After cancellation your subscription will still remain active until the end of the month for which you have paid.

If you pay by manual invoicing and would like to cancel your subscription, please contact our support team.

You can find invoices and transaction history in the ‘Payments’ section of your settings.

Note that you need to add your company information in the ‘Invoice info’ tab in your personal account.

For bank transfer payments, our support team send invoices directly to your email. You can always contact us if you have any questions.

Please note that you can upgrade or downgrade only one of the professional subscriptions.

If you pay by monthly recurring payments (via payment card):

Please log in to your account on our website, then use the “Subscribe” button underneath the desired plan in your personal account.

You will be charged immediately when you upgrade or downgrade your subscription. Note, that for your automatic subscription there is no any recalculation of payment that has already been done. To avoid double payment, we recommend you to change your subscription plan at the end of the month for which you have paid.

For example, if you have a Startup subscription and your billing payment date is the 15th day of each month, we would recommend to upgrade/downgrade your subscription on the 14th.

If you pay by manual invoice

You can сhange your subscription plan by contacting us.

If you have subscribed via our website and are paying for your monthly subscription automatically, our system will make several attempts (up to 4) to charge your payment card. These attempts will happen with a minimum of 1-day difference between each charging attempt.

In case we are not able to charge you after the final attempt, your subscription will be cancelled automatically, and your account will be suspended.

You have to contact us for help if your account was suspended.

You can always delete your account in the “My profile/Privacy centre” section of your settings.

For the plans between Free and Professional, the attribution requirement is obligatory. When it is required by your license you should place the following information in the visible part of your solution:

• ‘Weather data provided by OpenWeather’
• Hyperlink to our website https://openweathermap.org/
• OpenWeather logo. We provide a library of different styles to match your application design. You can download them here.

If you have any doubts about your specific scenario, please reach out to our support team and we will be glad to advise.

If you also believe in the significance of climate data in tackling climate and healthcare challenges and would like to contribute to our initiatives, then we invite you to connect your automated weather station to our platform. The accuracy of weather data benefits from enthusiasts from all over the world and we reward these contributions with our Startup plan.

To contribure your data to our ssytem, please use the Weather station API. To get access to the Startup plan, please contact us.

In the Current Weather API and Hourly Forecast API:

As it is a current weather data that reflect weather conditions only for the current moment, we add optional statistical parameters the temp_min and temp_max fields to show dispersion of temperature at this current moment. This is the minimum/maximum currently observed temperature or forecast temperature (within large megalopolises and urban areas).

In the 16-Day Forecast API and 30-Day Forecast

The list.temp.min and list.temp.max fields are minimum/maximum daily temperature, and show the minimum and maximum temperatures in the day.

The JSON format is used by default. To get data in the XML or HTML format, just use “xml” or “html” for the mode parameter. The HTML format is available for Current Weather API only. For the One Call API 3.0, data is only available in the JSON format. If the mode parameter is omitted, the format is JSON by default.

Examples of API calls:

• JSON: api.openweathermap.org/data/2.5/weather?q=London&{YOUR_API_KEY}
• XML: api.openweathermap.org/data/2.5/weather?q=London&mode=xml&{YOUR_API_KEY}
• HTML: api.openweathermap.org/data/2.5/weather?q=London&mode=html&{YOUR_API_KEY}

Temperature is available in Fahrenheit, Celsius and Kelvin units. Kelvin is used by default, with no need to use the units parameter in API calls.

For temperature in Fahrenheit, use "units=imperial".

For temperature in Celsius, use "units=metric".

You can find examples of API calls in the documentation for the service you are interested in.

A full list of all API parameters, with units, can be found here.

A list of weather condition codes with icons (range of thunderstorm, drizzle, rain, snow, clouds, atmosphere including extreme conditions such as tornado or hurricane) can be found here.

You are free to use these icons in your own solutions.

Requesting API calls by geographical coordinates is the most accurate way to specify any location. If you need to convert city names and zip-codes to geo coordinates and the other way around automatically, please use our Geocoding API.

However, some of our APIs support in-built geocoding, which allows users to call weather data by city name, city ID and Zip-code. If the chosen API supports built-in geocoding, then you will find the «Buil-it geocoding» section in the API documentation.

We support over 200,000 cities worldwide and our data is available for any coordinates around the globe. However, we don’t recommend using large locations or countries as it will not be weather data for a large location (aggregated data or averages), but weather data for a central point of the territory.

For current and forecast products (Current API, Hourly Forecast API, Daily Forecast for 16 days, Climatic forecast for 30 days, 5 day/3 hour forecast data) can be downloaded here.

Please note that you can also make requests to our APIs by using coordinates, ZIP codes, etc. Please refer to documentation of specific API to see all available options.

You can get the error 401 in the following cases:

• You did not specify your API key in API request.
• Your API key is not activated yet. Within the next couple of hours, it will be activated and ready to use.
• You are using wrong API key in API request. Please, check your right API key in personal account.
• You are using a Free subscription and try requesting data available in other subscriptions . For example, 16 days/daily forecast API, any historical weather data, Weather maps 2.0, etc). Please, check your subscription in your personal account.

You can get this error when you specified the wrong city name, ZIP-code or city ID. For your reference, this list contains City name, City ID, Geographical coordinates of the city (lon, lat), Zoom, etc.

You can also get the error 404 if the format of your API request is incorrect. In this case, please review it and check for any mistakes. To see examples of correct API requests, please visit the Documentation of a specific API and read the examples of API calls there.

You can recieve this error in the following cases:

• If you have a Free plan of Professional subscriptions and make more than 60 API calls per minute (surpassing the limit of your subscription). To avoid this situation, please consider upgrading to a subscription plan that meets your needs or reduce the number of API calls in accordance with the limits.