🍺 FUSS API - Getränke-Angebots-API v2.0

🚀 Übersicht

Die FUSS API durchsucht automatisch Getränke-Angebote deutscher Händler und liefert aktuelle Preise für Bier, Wein, Spirituosen und andere Getränke zurück.

🎯 Neu in v2.0: Blitzschnelle Suche ohne nächtliches Caching, intelligentes Cache-Management (1h pro Suche) und tägliche Cache-Löschung um 00:01 Uhr.

-

Uptime (Stunden)

-

Cache Einträge

-

Cache Hit Rate

v2.0

API Version

✨ Features

Blitzschnell: Optimierte Suche in unter 5 Sekunden
GPS-genau: Automatische Standortermittlung
Intelligent gecacht: 1h Cache pro Suche
Tägliche Aufräumung: Cache wird täglich um 00:01 geleert
Live-Tests: Direkt in der Dokumentation testen
RESTful: Saubere API-Struktur

🛠 Technische Details

Backend: FastAPI + Selenium WebDriver
Cache: In-Memory mit automatischer Bereinigung
Geschwindigkeit: Erste Suche ~5s, Cache-Hits ~0.5s
Datenquelle: KaufDA.de mit optimiertem Scraping

📡 API Endpunkte

GET Produktsuche via URL

URL: /search?city=STADT&product=PRODUKT

Beschreibung: Sucht Getränkeangebote in einer deutschen Stadt

Parameter:

city - Deutsche Stadt (z.B. Berlin, München)
product - Gesuchtes Produkt (z.B. Bier, Veltins)

POST Produktsuche via JSON

URL: /search

Content-Type: application/json

Body:

{
  "city": "Berlin",
  "product": "Bier"
}

GET GPS-Koordinaten

URL: /coordinates/{city}

Beschreibung: Ermittelt GPS-Koordinaten und Postleitzahl einer deutschen Stadt

GET Health Check

URL: /health

Beschreibung: API-Status und Systeminformationen

GET Cache-Statistiken

URL: /cache/stats

Beschreibung: Zeigt Cache-Performance und Statistiken

DELETE Cache leeren

URL: /cache

Beschreibung: Löscht alle gecachten Suchergebnisse

💡 Beispiele

🍺 Einfache Biersuche

GET https://fussapi.duckdns.org/search?city=Berlin&product=Bier

🏷 Spezifische Markensuche

GET https://fussapi.duckdns.org/search?city=München&product=Veltins

📝 POST-Request mit JSON

curl -X POST "https://fussapi.duckdns.org/search" \
  -H "Content-Type: application/json" \
  -d '{
    "city": "Hamburg", 
    "product": "Weißbier"
  }'

🌍 GPS-Koordinaten abrufen

GET https://fussapi.duckdns.org/coordinates/Köln

💡 Tipp: Verwenden Sie bekannte Markennamen für gezielte Suchen oder allgemeine Begriffe wie "Bier", "Pils" für eine größere Auswahl.

🧪 Live API Tests

🔍 Produktsuche testen

Stadt:

Produkt:

🌍 GPS-Test

Stadt:

📊 System-Status

📋 API Antworten

✅ Erfolgreiche Produktsuche

{
  "success": true,
  "total_offers": 15,
  "filtered_offers": 15,
  "city": "Berlin",
  "product": "Bier",
  "search_time_seconds": 4.23,
  "timestamp": "2025-06-27T15:30:45.123456",
  "location_data": {
    "lat": 52.5200,
    "lng": 13.4050,
    "zip": "10115"
  },
  "cache_hit": false,
  "offers": [
    {
      "title": "Veltins Pilsener 20x0,5l Kasten",
      "subtitle": "REWE",
      "mainPrice": "14,99 €",
      "secondaryPrice": "",
      "basePrice": "1,50 € / l",
      "imageUrl": "https://..."
    }
  ]
}

🌍 GPS-Koordinaten Response

{
  "success": true,
  "city": "Berlin",
  "location": {
    "lat": 52.5200,
    "lng": 13.4050,
    "zip": "10115"
  },
  "timestamp": "2025-06-27T15:30:45.123456"
}

❤️ Health Check Response

{
  "status": "healthy",
  "timestamp": "2025-06-27T15:30:45.123456",
  "version": "2.0.0",
  "cache_entries": 12,
  "uptime_hours": 24.5
}

⚠️ Fehler-Response

{
  "detail": "Stadt und Produkt sind erforderlich"
}

🕐 Cache-Verhalten: Suchergebnisse werden 1 Stunde gecacht. Der komplette Cache wird täglich um 00:01 Uhr geleert für frische Daten.

⚙️ Admin Panel

🔧 Für Entwickler: Hier finden Sie erweiterte API-Funktionen und Monitoring-Tools.

📊 Erweiterte Statistiken

🔗 Nützliche Links

📚 FastAPI Docs 📖 ReDoc