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

Clinical & Lifestyle Diet Templates (158 Types)

Search verified clinical and lifestyle diet templates authored by official nutritionists. Filter by 158 specialized diet types (keto, hashimoto, low-FODMAP, vegan, etc.), duration in days (3, 7, 14, 21, 28), calorie ranges, and exclude allergens with avoid_allergens.

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

Parametry zapytania

8 Parametr
Parametr Typ danych Wymagalność Opis parametru Przykład
query string Opcjonalny Search keyword or condition (e.g. "keto", "cukrzyca") —
diet_template_type string|int Opcjonalny Diet template type ID, find code, or localized name (e.g. "keto", "hashimoto", 4) —
days integer Opcjonalny Duration in days (e.g. 7, 14, 21, 28) —
avoid_allergens array Opcjonalny Allergen find codes to strictly exclude (e.g. ["milk", "nuts"]) []
kcal_min / kcal_max integer Opcjonalny Daily calorie bounds 0
currency string Opcjonalny Currency for pricing (PLN, EUR, USD, ALL) locale default
locale string Opcjonalny Language locale (en, pl, de, etc.) en
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/diet
terminal — POST /api/v1/diet
REST HTTP/2 REQUEST
curl -X POST 'https://www.dietspremium.com/api/v1/diet' 
curl -X POST "https://www.dietspremium.com/api/v1/diet" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "diet_template_type": "keto",
  "days": 28,
  "avoid_allergens": ["milk"],
  "currency": "ALL",
  "locale": "pl"
}'

Przykładowa odpowiedź JSON (200 OK)

HTTP/2 200 OK • application/json
response — /api/v1/diet (200 OK)
JSON Payload 200 OK 
{
  "items": [
    {
      "id": 16,
      "name": "Shape & Power 1800 kcal",
      "days_count": 28,
      "has_price": true,
      "store": [
        {"name": "Lidl"}
      ],
      "price": {
        "cost_per_day": 20.12,
        "total_cost": 563.40,
        "currency": "PLN",
        "weekly_breakdown": {
          "week_1": 164.32,
          "week_2": 125.46,
          "week_3": 129.41,
          "week_4": 144.21
        }
      }
    }
  ],
  "total": 1,
  "page": 1
}
Obsługa paginacji i filtrów dla /api/v1/diet 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_diet 200 OK

Klient HTTP dla zasobu Clinical & Lifestyle Diet Templates (158 Types)

REST API v1 + OpenSearch
Prompt Wejściowy Agenta AI

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

Wykorzystywane Narzędzia MCP / Endpointy
POST /api/v1/diet
Ślad Wywołania (Execution Trace) 
→ POST /api/v1/diet (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/food-world Global Food Products & Barcodes (Open Food Facts + USDA)

Udostępnij