Lebensmittel API Dokumentation

Die API ermöglicht den Zugriff auf Nährwertdaten von Lebensmitteln sowie deren Filterung nach verschiedenen Kriterien.

1. Lebensmittel abfragen

Dieser Endpunkt gibt eine Liste von Lebensmitteln zurück. Du kannst optional nach einem Suchbegriff und einer Gruppe filtern.

Beispielaufruf

GET https://teitge.de/wp-json/food-api/v1/foods?search=Apfel&group=Obst
Parameter:
  • search: (optional) Ein Suchbegriff, nach dem in den Lebensmittel-Daten gefiltert wird.
  • group: (optional) Die Gruppe, nach der gefiltert wird (z.B. "Obst", "Gemüse").
Beispielantwort:
{
    "id": "3",
    "name": "Apfel",
    "subname": "Roter Apfel",
    "keywords": "Apfel, Rot",
    "group": "4",
    "Energie (kcal)": 52,
    "Fett (g)": 0.17,
    "Eiweiß (g)": 0.26,
    "Kalium (mg)": 115,
    "Phosphat (mg)": 20
}

2. Alle Gruppen abrufen

Dieser Endpunkt gibt alle verfügbaren Lebensmittel-Gruppen zurück, z.B. "Obst", "Gemüse", etc.

Beispielaufruf

GET https://teitge.de/wp-json/food-api/v1/groups
Beispielantwort:
[
    { "id": "1", "name": "Getreideprodukte und Hülsenfrüchte", "icon": "fas fa-bread-slice" },
    { "id": "2", "name": "Getränke", "icon": "fas fa-tint" },
    { "id": "3", "name": "Gemüse", "icon": "fas fa-carrot" },
    { "id": "4", "name": "Obst", "icon": "fas fa-apple-alt" }
]

3. Lebensmittel nach Filterkriterien abrufen

Dieser Endpunkt ermöglicht die Filterung von Lebensmitteln anhand von Eigenschaften wie "Fett", "Zucker" und weiteren Nährstoffen.

Beispielaufruf

GET https://teitge.de/wp-json/food-api/v1/filter-foods?property=Fett&operator=%3E&value=10
Parameter:
  • property: Die Eigenschaft des Lebensmittels, nach der gefiltert wird (z.B. "Fett", "Kalium").
  • operator: Der Operator für den Vergleich. Mögliche Werte: >, <, =, >=, <=, != (z.B. "Fett > 10").
  • value: Der Wert, mit dem verglichen werden soll (z.B. "10").
Beispielantwort:
[
    { "id": "a588375e2e29bdbe796e65b4c6fad2bb", "name": "Rumkugeln", "Fett (g)": 10 },
    { "id": "94b16602e175b71b210cfcc058b32edf", "name": "Karotte", "Fett (g)": 13.7 }
]

4. Rate Limiting

Die API implementiert ein Rate Limiting, um eine Überlastung zu verhindern. Eine IP-Adresse darf nur maximal 100 Anfragen in 10 Minuten senden.

Fehlermeldung bei Überschreitung des Limits

{
    "code": "too_many_requests",
    "message": "Zu viele Anfragen in kurzer Zeit. Du hast bereits 100 von 100 Anfragen gemacht. Bitte versuche es wieder in 00:02:00 Minuten."
}

5. API Status

Alle Endpunkte sind öffentlich zugänglich, ohne dass eine Authentifizierung erforderlich ist. Falls eine Anfrage aufgrund von Rate Limiting oder fehlenden Parametern fehlschlägt, erhalten Sie eine Fehlerantwort mit dem entsprechenden Statuscode und einer Nachricht.