# 🌐 Aggregated Insights API

This ASP.NET Core Web API aggregates data from three external sources — weather, tech news, and global country metadata — into a single unified response. It’s designed for fast, parallel data fetching and clean JSON output.

---

## 🚀 Features

- 🌤 **Weather Data** from [Open-Meteo](https://open-meteo.com/)
- 📰 **Tech News Item** from [Hacker News API](https://github.com/HackerNews/API)
- 🌍 **Country Metadata** from [World Bank API](https://datahelpdesk.worldbank.org/knowledgebase/articles/898590-api-country-queries)

---

## 📦 Aggregated Endpoint

### `GET /api/Aggregation`

Retrieves weather info, a Hacker News item, and country metadata in one call.

#### 🔧 Query Parameters

| Name              | Type   | Required | Description                              |
|-------------------|--------|----------|------------------------------------------|
| `city`            | string | ✅       | City name for weather lookup             |
| `hackerNewsItemId`| int    | ✅       | Hacker News item ID                      |
| `countryCode`     | string | ✅       | ISO 2-letter country code (e.g. `GR`)    |

---

### 📘 Example Request

```http
GET https://localhost:7145/api/Aggregation?city=Athens&hackerNewsItemId=1213&countryCode=GR

---

✅ Example Response

{
  "weather": {
    "city": "Athens",
    "description": "Clear sky",
    "temperature": 28.7,
    "windSpeed": 12.3,
    "humidity": 42
  },
  "hackerNewsItem": {
    "id": 1213,
    "by": "pg",
    "title": "Lisp as the Language of the Future",
    "text": "Lisp has been around for decades...",
    "type": "story",
    "score": 57,
    "time": 1175714200
  },
  "worldBankCountry": {
    "id": "GRC",
    "iso2Code": "GR",
    "name": "Greece",
    "region": "Europe & Central Asia",
    "adminRegion": "",
    "incomeLevel": "High income",
    "lendingType": "IBRD",
    "capitalCity": "Athens",
    "latitude": 37.9838,
    "longitude": 23.7275
  }
}

---

🧱 Architecture Overview

• OpenMeteoService → Fetches weather data using static city coordinates
• HackerNewsService → Retrieves a single Hacker News item by ID
• WorldBankCountryService → Fetches country metadata by ISO code
• AggregationService → Combines all three into a single response
• AggregationController → Exposes the /api/Aggregation endpoint

---

🛠 Setup Instructions

1. Clone the repository
2. Register services in Program.cs:

builder.Services.AddHttpClient<IWeatherService, OpenMeteoService>();
builder.Services.AddHttpClient<IHackerNewsService, HackerNewsService>();
builder.Services.AddHttpClient<IWorldBankCountryService, WorldBankCountryService>();
builder.Services.AddScoped<IAggregationService, AggregationService>();

3. Run the project and access:

https://localhost:7145/api/Aggregation?city=Athens&hackerNewsItemId=1213&countryCode=GR

---

📌 Notes

• Weather data uses static coordinates via CityCoordinates.cs
• Hacker News items are parsed dynamically using JsonDocument
• World Bank responses are cleanly mapped without [JsonPropertyName]

---

📣 Future Enhancements

• Add caching for repeated requests
• Support batch queries for multiple cities or countries
• Add Swagger/OpenAPI documentation
• Optional: Convert to GraphQL for flexible querying

---

👨‍💻 Author

Built by Anastasios — powered by curiosity, clean code, and Copilot.

---

Let me know if you want this styled for GitHub Pages or turned into a full developer portal.