API code-barres

Integrate barcode lookup and analysis directly into your applications.

POST

1. Authentification

Ce point de terminaison permet de s'authentifier et d'obtenir un jeton d'accès. Le jeton est nécessaire pour les requêtes API suivantes.

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

2. Obtenir un code-barres

Ce point de terminaison permet d'obtenir les informations d'un code-barres précis : nom du produit, prix et disponibilité.

Autorisation :: Cette requête nécessite un jeton valide dans l'en-tête
/api/barcode
Request
{
  "barcode": "8690632994802"
}
Response Example
[
  {
    "barcode": "8690...",
    "text": "Product Name...",
    "prices": []
  }
]
Essayer
Auth
* Auto-filled from Authentication step
Code-barres

                            
POST

3. Valeurs nutritionnelles

Calories, matières grasses, glucides, protéines, sucres, sodium, vitamines et minéraux d'un produit, pour 100 g (ou 100 ml) et par portion, avec les ingrédients. Données issues d'USDA FoodData Central et d'Open Food Facts. Chaque appel compte dans votre quota quotidien, comme une recherche de code-barres.

Autorisation :: Cette requête nécessite un jeton valide dans l'en-tête
/api/nutrition
Request
{
  "barcode": "0016000275287"
}
Remarques
  • Unités : énergie en kcal ; nutriments en g, mg ou mcg (µg).
  • servingSize, servingUnit et perServing sont vides lorsque la source n'indique pas de portion.
  • dailyValue : pourcentage de la valeur quotidienne américaine (régime de 2 000 kcal) ; vide s'il n'y en a pas.
  • 404 avec {"error": "NO_NUTRITION_FACTS"} lorsque nous n'avons pas de valeurs nutritionnelles pour le produit.
  • source : usda-fdc ou openfoodfacts. Les données Open Food Facts sont sous licence ODbL : citez Open Food Facts là où vous les affichez.
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 }
  ]
}

Clés des nutriments : energy, fat, saturatedFat, transFat, cholesterol, sodium, carbohydrate, fiber, sugars, addedSugars, protein, vitaminD, calcium, iron, potassium (ordre de l'étiquette américaine ; seulement celles que le produit indique).

Essayer
Auth

                            
POST

4. Analyse du code-barres

Ce point de terminaison analyse le code-barres indiqué et renvoie des informations comme le pays d'origine, le code fabricant et le code produit.

/api/analysis
Essayer
Auth
Code-barres