Barcode-API

Integrate barcode lookup and analysis directly into your applications.

POST

1. Authentifizierung

Mit diesem Endpunkt authentifizieren sich Nutzer und erhalten ein Zugriffstoken. Das Token wird für alle weiteren API-Anfragen benötigt.

/api/auth/getToken
Request Body
{
  "userKey": "YOUR_USER_KEY",
  "apiKey": "YOUR_API_KEY"
}
Ausprobieren
POST

2. Barcode abrufen

Mit diesem Endpunkt rufen Sie Details zu einem bestimmten Barcode ab, darunter Produktname, Preisangaben und Verfügbarkeit.

Autorisierung:: Diese Anfrage erfordert ein gültiges Token im
/api/barcode
Request
{
  "barcode": "8690632994802"
}
Response Example
[
  {
    "barcode": "8690...",
    "text": "Product Name...",
    "prices": []
  }
]
Ausprobieren
Auth
* Auto-filled from Authentication step
Barcode

                            
POST

3. Nährwerte

Kalorien, Fett, Kohlenhydrate, Eiweiß, Zucker, Natrium, Vitamine und Mineralstoffe eines Produkts, pro 100 g (oder 100 ml) und pro Portion, mit Zutaten. Daten von USDA FoodData Central und Open Food Facts. Jeder Aufruf zählt wie eine Barcode-Abfrage zu Ihrem Tageskontingent.

Autorisierung:: Diese Anfrage erfordert ein gültiges Token im
/api/nutrition
Request
{
  "barcode": "0016000275287"
}
Hinweise
  • Einheiten: Energie in kcal; Nährstoffe in g, mg oder mcg (µg).
  • servingSize, servingUnit und perServing sind leer, wenn die Quelle keine Portionsgröße angibt.
  • dailyValue: Prozent des US-Tagesbedarfs (2.000-kcal-Ernährung); leer, wenn es keinen gibt.
  • 404 mit {"error": "NO_NUTRITION_FACTS"}, wenn wir keine Nährwerte für das Produkt haben.
  • source: usda-fdc oder openfoodfacts. Daten von Open Food Facts stehen unter der ODbL: Nennen Sie Open Food Facts dort, wo Sie sie anzeigen.
Response Example
{
  "barcode": "0016000275287",
  "source": "usda-fdc",
  "servingSize": 40.0,
  "servingUnit": "g",
  "householdServing": "1 cup (40 g)",
  "packageWeight": "18 oz",
  "category": "Cereal",
  "ingredients": "Whole grain oats, sugar, ...",
  "nutrients": [
    { "key": "energy", "unit": "kcal",
      "per100": 375.0, "perServing": 150.0,
      "dailyValue": null },
    { "key": "fat", "unit": "g",
      "per100": 5.0, "perServing": 2.0,
      "dailyValue": 3 },
    { "key": "sodium", "unit": "mg",
      "per100": 475.0, "perServing": 190.0,
      "dailyValue": 8 }
  ]
}

Nährstoffschlüssel: energy, fat, saturatedFat, transFat, cholesterol, sodium, carbohydrate, fiber, sugars, addedSugars, protein, vitaminD, calcium, iron, potassium (Reihenfolge des US-Etiketts; nur die, die das Produkt angibt).

Ausprobieren
Auth

                            
POST

4. Barcode-Analyse

Dieser Endpunkt analysiert den angegebenen Barcode und liefert Details wie Herkunftsland, Herstellercode und Produktcode.

/api/analysis
Ausprobieren
Auth
Barcode