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"
}
Примечания
  • Единицы: энергия в ккал; нутриенты в г, мг или мкг (µg).
  • servingSize, servingUnit и perServing пусты, если источник не указывает размер порции.
  • dailyValue: процент от суточной нормы США (рацион 2000 ккал); пусто, если её нет.
  • 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
Штрихкод