Cloud-Cast API Documentation

Introduction

The CloudCast API is a weather application that provides real-time weather data for cities around the world using data from the OpenWeatherMap API. It is built using Node.js and Express and provides various endpoints to access weather information such as current weather, weather forecast, hourly forecast, wind speed, and humidity.

Base URL

The base URL for the API is https://cloud-cast.p.rapidapi.com/weather.

Getting Started

API Endpoints

GET /

This is the homepage of the API. It responds with a welcome message.

Example:

GET https://cloud-cast.p.rapidapi.com/weather/

GET /weather/:city

This endpoint provides the current weather for a specified city. Replace :city with the name of the city you want the weather for.

Example:

GET https://cloud-cast.p.rapidapi.com/weather/london

GET /forecast/:city

This endpoint provides a weather forecast for the specified city. Replace :city with the name of the city you want the forecast for.

Example:

GET https://cloud-cast.p.rapidapi.com/weather/forecast/london

GET /hourly/:city

This endpoint provides an hourly weather forecast for the specified city. Replace :city with the name of the city you want the forecast for.

Example:

GET https://cloud-cast.p.rapidapi.com/weather/hourly/london

GET /wind/:city

This endpoint provides wind information for the specified city. Replace :city with the name of the city you want the wind information for.

Example:

GET https://cloud-cast.p.rapidapi.com/weather/wind/london

GET /humidity/:city

This endpoint provides humidity information for the specified city. Replace :city with the name of the city you want the humidity information for.

Example:

GET https://cloud-cast.p.rapidapi.com/weather/humidity/london

Error Handling

If an error occurs during the request, the API will return a JSON object with a message field containing a description of the error. For example:

{
    "message": "error message"
}

Conclusion

This concludes the documentation for the CloudCast API. Please feel free to ask any questions or report any issues. Happy coding!