Barkod API

POST

1. Kimlik Doğrulama

Bu uç nokta, kullanıcıların kimlik doğrulaması yapmasını ve bir erişim tokeni almasını sağlar. Token, sonraki API istekleri için gereklidir.

/api/auth/getToken

Request Body

{
  "userKey": "YOUR_USER_KEY",
  "apiKey": "YOUR_API_KEY"
}

Dene

POST

2. Barkod Getir

Bu uç nokta belirli bir barkod hakkında ürün adı, fiyat bilgisi ve stok durumu gibi ayrıntıları getirmenizi sağlar.

Yetkilendirme:: Bu istek geçerli bir token gerektirir.

/api/barcode

Request

{
  "barcode": "8690632994802"
}

Response Example

[
  {
    "barcode": "8690...",
    "text": "Product Name...",
    "prices": []
  }
]

Dene

POST

Besin değerleri

Bir ürünün enerji, yağ, karbonhidrat, protein, şeker, sodyum, vitamin ve mineral değerleri; 100 g (veya 100 ml) ve porsiyon başına, içindekilerle birlikte. Veriler USDA FoodData Central ve Open Food Facts kaynaklıdır. Her çağrı, barkod sorgusu gibi günlük kotanızdan düşer.

Yetkilendirme:: Bu istek geçerli bir token gerektirir.

/api/nutrition

Request

{
  "barcode": "0016000275287"
}

Notlar

Birimler: enerji kcal; besinler g, mg veya mcg (µg).
Kaynakta porsiyon bilgisi yoksa servingSize, servingUnit ve perServing boş gelir.
dailyValue: ABD Günlük Değeri yüzdesi (2.000 kcal diyet); yoksa boş.
Ürün için besin değeri yoksa {"error": "NO_NUTRITION_FACTS"} ile 404 döner.
source: usda-fdc veya openfoodfacts. Open Food Facts verileri ODbL lisanslıdır: gösterdiğiniz yerde Open Food Facts'i kaynak olarak belirtin.

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 }
  ]
}

Besin anahtarları: energy, fat, saturatedFat, transFat, cholesterol, sodium, carbohydrate, fiber, sugars, addedSugars, protein, vitaminD, calcium, iron, potassium (ABD etiket sırası; yalnızca üründe olanlar).

Dene

POST

3. Barkod Analizi

Bu uç nokta verilen barkodu analiz eder ve menşei ülkesi, üretici kodu ve ürün kodu gibi bilgileri sağlar.

/api/analysis