條碼 API

Integrate barcode lookup and analysis directly into your applications.

POST

1. 驗證

透過此端點完成驗證並取得存取權杖。之後的 API 請求都需要這個權杖。

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

2. 取得條碼

透過此端點可取得特定條碼的詳細資訊,包括商品名稱、價格和供貨狀況。

授權:: 此請求需要在以下位置提供有效權杖:
/api/barcode
Request
{
  "barcode": "8690632994802"
}
Response Example
[
  {
    "barcode": "8690...",
    "text": "Product Name...",
    "prices": []
  }
]
試試看
Auth
* Auto-filled from Authentication step
條碼

                            
POST

3. 營養標示

商品每 100 公克(或 100 毫升)及每份的熱量、脂肪、碳水化合物、蛋白質、糖、鈉、維生素和礦物質,並附成分。資料來自 USDA FoodData Central 和 Open Food Facts。每次呼叫與條碼查詢一樣計入每日配額。

授權:: 此請求需要在以下位置提供有效權杖:
/api/nutrition
Request
{
  "barcode": "0016000275287"
}
說明
  • 單位:能量為 kcal;營養素為 g、mg 或 mcg(µg)。
  • 來源未提供每份份量時,servingSize、servingUnit 和 perServing 為空。
  • dailyValue:占美國每日參考值的百分比(以 2000 kcal 飲食為準);沒有時為空。
  • 沒有該商品的營養資訊時,回傳 404 和 {"error": "NO_NUTRITION_FACTS"}。
  • source:usda-fdc 或 openfoodfacts。Open Food Facts 的資料採用 ODbL 授權:顯示時請註明 Open Food Facts。
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 }
  ]
}

營養素鍵:energy、fat、saturatedFat、transFat、cholesterol、sodium、carbohydrate、fiber、sugars、addedSugars、protein、vitaminD、calcium、iron、potassium(依美國標示順序;只含商品列出的項目)。

試試看
Auth

                            
POST

4. 條碼分析

此端點會分析指定的條碼,並回傳原產國、廠商代碼和商品代碼等資訊。

/api/analysis
試試看
Auth
條碼