Diets Premium Diets Premium
Anmelden
Katalog Narzędzi MCP & Endpointów REST API
Widgety: Specyfikacja Tabela parametrów Terminal SDK & Odpowiedź Kody HTTP & AI Kafelki API v1
Zurück zur REST-API-Dokumentation 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

Anfrageparameter

8 Parameter
Parameter Datentyp Status Beschreibung Beispiel
query string Optional Search keyword or condition (e.g. "keto", "cukrzyca") —
diet_template_type string|int Optional Diet template type ID, find code, or localized name (e.g. "keto", "hashimoto", 4) —
days integer Optional Duration in days (e.g. 7, 14, 21, 28) —
avoid_allergens array Optional Allergen find codes to strictly exclude (e.g. ["milk", "nuts"]) []
kcal_min / kcal_max integer Optional Daily calorie bounds 0
currency string Optional Currency for pricing (PLN, EUR, USD, ALL) locale default
locale string Optional Language locale (en, pl, de, etc.) en
page integer Optional Pagination page index 1
Diagnostyka i Odporność

HTTP-Statuscodes

Kod HTTP Status Znaczenie i Obsługa
200 OK Sukces Anfrage erfolgreich verarbeitet
400 Bad Request Błąd walidacji Ungültige Eingabeparameter
401 Unauthorized Brak autoryzacji Fehlender oder ungültiger X-API-KEY
429 Too Many Requests Rate Limit Anfragelimit überschritten
500 Server Error Błąd serwera Interner Serverfehler

Beispiel-HTTP-Anfrage

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"
}'

Beispiel-JSON-Antwort (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 DE 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=de, ai=true)
← 200 OK (application/json)

Weitere REST-API-Endpunkte

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)

Teilen