Diets Premium Diets Premium
Zaloguj się
Katalog Narzędzi MCP & Endpointów API Platform 5.0
Widgety: Specyfikacja Tabela parametrów Terminal SDK & Odpowiedź Kody HTTP & AI Kafelki API v1
Wróć do dokumentacji REST API POST /api/v1/food-world
search_food_world

Global Food Products & Barcodes (Open Food Facts + USDA)

Comprehensive global food catalog integrating Open Food Facts and USDA FoodData Central. Query products by commercial barcode (EAN-13, UPC), manufacturer brand, localized product title, categories, and country of origin with multi-currency pricing.

Pełny adres URL https://dietspremium.pl/api/v1/food-world
Format odpowiedzi application/json; charset=utf-8
Autoryzacja Authorization: Bearer <API_KEY>
Specyfikacja Parametrów HTTP

Parametry zapytania

6 Parametr
Parametr Typ danych Wymagalność Opis parametru Przykład
query string Opcjonalny Product name or keywords (e.g. "Coca-Cola Zero", "Nutella") —
barcode string Opcjonalny EAN-13 or UPC barcode string (e.g. "5449000000996") —
brand string Opcjonalny Manufacturer / brand name (e.g. "Barilla", "Nestle") —
locale string Opcjonalny Target language locale en
currency string Opcjonalny Currency for pricing (EUR, PLN, USD, ALL) locale default
page integer Opcjonalny Pagination page index 1
Diagnostyka i Odporność

Kody statusu HTTP

Kod HTTP Status Znaczenie i Obsługa
200 OK Sukces Zapytanie przetworzone pomyślnie
400 Bad Request Błąd walidacji Nieprawidłowe parametry wejściowe
401 Unauthorized Brak autoryzacji Brak lub nieprawidłowy klucz X-API-KEY
429 Too Many Requests Rate Limit Przekroczono limit zapytań pakietu
500 Server Error Błąd serwera Wewnętrzny błąd serwera

Przykładowe zapytanie HTTP

POST /api/v1/food-world
terminal — POST /api/v1/food-world
REST HTTP/2 REQUEST
curl -X POST 'https://dietspremium.pl/api/v1/food-world' 
curl -X POST "https://dietspremium.pl/api/v1/food-world" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "query": "barilla spaghetti",
  "brand": "Barilla",
  "locale": "pl",
  "currency": "ALL"
}'

Przykładowa odpowiedź JSON (200 OK)

HTTP/2 200 OK • application/json
response — /api/v1/food-world (200 OK)
JSON Payload 200 OK 
{
  "items": [
    {
      "id": 104291,
      "name": "Spaghetti n.5",
      "brand": "Barilla",
      "barcode": "8076809513753",
      "nutriscore_grade": "a",
      "ecoscore_grade": "b",
      "kcal": 359,
      "proteins": 12.5,
      "fats": 2.0,
      "carbs": 70.9,
      "has_price": true,
      "price": {
        "amount": 1.49,
        "currency": "EUR"
      }
    }
  ],
  "total": 1,
  "page": 1
}
Obsługa paginacji i filtrów dla /api/v1/food-world Best Practice

Zalecenia produkcyjne dla deweloperów
1
Kontrola strony i rozmiaru kolekcji page / max_results

Sprawdzaj flagę "hasMore" oraz "total" w odpowiedzi JSON przed pobraniem kolejnej strony.

2
Wyszukiwanie semantyczne vs dokładne ai=true

Ustaw ai=true dla zapytań w języku naturalnym lub ai=false dla ścisłego dopasowania słów kluczowych.

ApiClient_food_world 200 OK

Klient HTTP dla zasobu Global Food Products & Barcodes (Open Food Facts + USDA)

REST API v1 + OpenSearch
Prompt Wejściowy Agenta AI

“Pobierz dane z /api/v1/food-world dla języka PL z użyciem wektora k-NN.”

Wykorzystywane Narzędzia MCP / Endpointy
POST /api/v1/food-world
Ślad Wywołania (Execution Trace) 
→ POST /api/v1/food-world (locale=pl, ai=true)
← 200 OK (application/json)

Pozostałe punkty końcowe REST API

Pełny katalog REST API →
POST /api/v1/allergen Allergen Search & Intolerance Detection
POST /api/v1/article Article & Clinical Nutrition Guides
POST /api/v1/company Company & Dietetic Catering Directory
POST /api/v1/exercise Exercise & Biomechanics Database
POST /api/v1/food Food & Nutrient Database
POST /api/v1/medication Medication & Food-Drug Interactions
POST /api/v1/recipe Recipe & Culinary Meal Database
POST /api/v1/user Specialist & Certified Dietitian Directory
POST /api/v1/supplement Supplement & Active Substance Database
POST /api/v1/diet Clinical & Lifestyle Diet Templates (158 Types)

Udostępnij