Frequently Asked Questions (FAQ) about Hava Durumu API Asistanı

Q: What is the Hava Durumu API Asistanı? A: The Hava Durumu API Asistanı is a Flask web service that provides real-time weather information for cities using the OpenWeather API. It’s designed to be integrated with AI Agents.

Q: What kind of weather information does it provide? A: It provides current weather data including temperature, humidity, wind speed, weather descriptions, and the ‘feels like’ temperature.

Q: Is the weather information in Turkish? A: Yes, the weather descriptions are in Turkish by default.

Q: What is Swagger UI? A: Swagger UI is an interactive API documentation tool that allows you to explore the API’s endpoints, test them, and generate code snippets.

Q: How do I get an OpenWeather API key? A: You can sign up for a free API key at OpenWeather.

Q: How do I configure the API key? A: Create a .env file, and set the OPENWEATHER_API_KEY variable to your API key.

Q: How do I run the application? A: Run the command python app_swagger.py.

Q: How do I access the Swagger UI? A: Open your browser and navigate to http://localhost:5001/swagger/.

Q: What are the supported API endpoints? A: The API supports two endpoints: GET /api/v1/weather?city=<şehir_ismi> (query parameter) and GET /api/v1/weather/<şehir_ismi> (path parameter).

Q: What happens if I enter an invalid city name? A: The API will return an error message indicating that the city name is invalid.

Q: How do I integrate this with UBOS? A: Configure your AI Agent to communicate with the API Asistanı’s endpoint using the MCP protocol. UBOS provides tools and frameworks to simplify this integration.

Q: Is the API secure? A: The API key is stored securely in an environment variable, and sensitive information is prevented from being committed to the repository using .gitignore.