ONLINE • 512d k-NN
Katalog Narzędzi MCP & Endpointów API Platform 5.0
Food & Nutrient Database
Comprehensive laboratory-verified nutritional catalog. Query whole ingredients and packaged foods by exact calorie bounds, minimum/maximum protein, fat and carb macros, micronutrient density, and allergen exclusions.
Pełny adres URL
https://www.dietspremium.pl/api/v1/food
Format odpowiedzi
application/json; charset=utf-8
Autoryzacja
Authorization: Bearer <API_KEY>
Specyfikacja Parametrów HTTP
7 Parametr
Parametry zapytania
| Parametr | Typ danych | Wymagalność | Opis parametru | Przykład |
|---|---|---|---|---|
query
|
string | Wymagany | Food item or ingredient (e.g. "grilled chicken breast", "avocado") | —
|
locale
|
string | Opcjonalny | Language locale | en
|
kcal_min / kcal_max
|
integer | Opcjonalny | Calorie thresholds per 100g | 0
|
proteins_min
|
integer | Opcjonalny | Minimum protein content in grams | 0
|
allergen_exclude
|
string | Opcjonalny | Comma-separated allergens to exclude | —
|
food_nutrient_include
|
string | Opcjonalny | Include specific micronutrient (e.g. "iron", "calcium") | —
|
ai
|
boolean | Opcjonalny | AI semantic search | true
|
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
terminal — POST /api/v1/food
REST HTTP/2
REQUEST
curl -X POST 'https://www.dietspremium.pl/api/v1/food'
curl -X POST "https://www.dietspremium.pl/api/v1/food" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"query": "chicken breast",
"locale": "en",
"proteins_min": 25,
"kcal_max": 250,
"allergen_exclude": "gluten,lactose",
"ai": true
}'Przykładowa odpowiedź JSON (200 OK)
HTTP/2 200 OK • application/json
response — /api/v1/food (200 OK)
JSON Payload
200 OK
{
"items": [
{"id": 12, "name": "Chicken Breast Raw", "kcal": 165, "proteins": 31.0, "fats": 3.6, "carbs": 0.0}
],
"total": 1
}
Obsługa paginacji i filtrów dla /api/v1/food
Best Practice
Zalecenia produkcyjne dla deweloperów
Obsługa paginacji i filtrów dla /api/v1/food
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
200 OK
Klient HTTP dla zasobu Food & Nutrient Database
Prompt Wejściowy Agenta AI
“Pobierz dane z /api/v1/food dla języka PL z użyciem wektora k-NN.”
Wykorzystywane Narzędzia MCP / Endpointy
POST /api/v1/food
Ślad Wywołania (Execution Trace)
→ POST /api/v1/food (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/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)
POST /api/v1/food-world
Global Food Products & Barcodes (Open Food Facts + USDA)