条码 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
条码