Postman is a collaboration tool designed to help you explore, design, and test APIs. AerisWeather now includes a GitHub repository with the necessary Postman files to get you up and running with common queries. For the more experienced Postman users, feel free to jump right into the repository.
Clone the aerisweather/aeriswx-postman repo from GitHub:
git clone firstname.lastname@example.org:aerisweather/aeriswx-postman.git
Within Postman, select the Import option. Please note, the web based application looks slightly different, but the import button is in the same area.
Import the ./AerisWeather_API.postman_collection.json file from your local project directory. Next, we will need to import the environment. Use the Manage Environments button to import a new environment. Please note, the web application will use the previously mentioned import button.
Import the ./AerisWeather_API.postman_environment.json file and select the environment. Now we need to add a CLIENT_ID, CLIENT_SECRET, and location variable. The env variable is already setup to hit the AerisWeather API service directly. There is no need to change this value unless you want to use a proxy server or CDN to route your requests to AerisWeather. Verify the AerisWeather_API environment is selected within the Postman application and you’re ready to go!
Each request contains a description of what that request will provide, along with a link to the official documentation for that endpoint. The collection also contains a batch request. Batch requests can be helpful when you want to generate a single query to get all your weather data needs. However, the batch feature is not intended to reduce the number of API hits as it pertains to your daily limit.
Of these requests, we explore the following endpoints:
Each endpoint has unique features that can be explored further by diving into the official documentation.
Have you found a unique way to use the AerisWeather API? We’d love to see your use case for weather data. Contribute to the aerisweather/aeriswx-postman repository and share your ideas with the world!