Diets Premium Diets Premium
Zaloguj się
Katalog Narzędzi MCP & Endpointów REST API
Widgety: SDK & Terminal Architektura & Nagłówki Kafelki Endpointów v1 Subagent & Paginacja
REST API v1 • OPENAPI 3.1 REST HTTP/2 JSON • OpenAPI 3.1
MCP Server v2.0 →

Kliniczne REST API dla Aplikacji Zdrowotnych i Gabinetów

Integruj 12 000+ produktów spożywczych, 38 mikroelementów, przepisy, plany dietetyczne i atlas ćwiczeń bezpośrednio w swoim oprogramowaniu.

Base URL https://www.dietspremium.com/api/v1
Autoryzacja HTTP Authorization: Bearer <KEY>
Dostępne Zasoby 11 Endpointów REST v1
Przeglądaj Kafelki Endpointów (11) Nagłówki & Kontrakt HTTP
02 • Krok 2 • Integracja kodu

Przykład wywołania cURL / HTTP

HTTP/2 JSON
terminal — REST API v1 SDK
HTTP/2 POST 200 OK
curl -X POST https://www.dietspremium.com/api/v1/food 
curl -X POST "https://www.dietspremium.com/api/v1/food" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"query": "awokado", "locale": "pl", "ai": true, "max_results": 5}'
01 • Krok 1 • Autoryzacja

Szybkie wdrożenie w 3 krokach

HTTPS JSON

Od wygenerowania klucza X-API-KEY do pierwszego zapytania produkcyjnego w mniej niż 2 minuty.

01

1. Wygeneruj klucz API

Utwórz klucz w panelu konta i przypisz uprawnienia odczytu lub zarządzania.

02

2. Wyślij zapytanie HTTPS

Przekaż nagłówek X-API-KEY do wybranego punktu końcowego wyszukiwania k-NN.

03

3. Odbierz ustrukturyzowany JSON

Korzystaj z gotowych wyliczeń makroskładników, alergenów i powiązań klinicznych.

Nagłówek / Parametr Wartość Przeznaczenie
Accept / Content-Type application/json Wymusza komunikację w ustrukturyzowanym formacie JSON UTF-8.
Authorization Bearer YOUR_API_KEY Token autoryzacyjny z panelu konta (lub nagłówek X-API-KEY).
locale & ai locale="pl", ai=true Włącza 9-językową lokalizację oraz semantyczny wektor OpenSearch 512d k-NN.
Cykl żądania HTTP w REST API v1 REST Flow

Standardowa integracja dla aplikacji webowych, mobilnych i backendowych
1
Uwierzytelnienie nagłówkiem Bearer / X-API-KEY Header Auth

Przekaż klucz API w nagłówku Authorization: Bearer <API_KEY> lub X-API-KEY.

2
Zapytanie z parametrami query, locale oraz ai=true POST /api/v1/*

Silnik OpenSearch k-NN zwraca spaginowaną kolekcję items, total, page, perPage i hasMore.

3
Obsługa paginacji i wielojęzycznych wartości odżywczych 9 Locales

Dane zwracane są natychmiast w wybranym języku (pl, de, en, fr, nl, cz, at, ch, lu).

03 • Krok 3 • Katalog Endpointów 11 Endpoints

Katalog Punktów Końcowych REST API

Przeglądaj wszystkie zasoby żywieniowe, treningowe i medyczne dostępne przez HTTPS.

POST /api/v1/allergen JSON

Allergen Search & Intolerance Detection

Access the comprehensive EU 1169/2011 allergens registry, cross-contamination warnings, and ingredient intolerance codes.

Parametry Payload (4):
query* locale page ai
200 OK • OpenSearch Specyfikacja
POST /api/v1/article JSON

Article & Clinical Nutrition Guides

Search 6,000+ peer-reviewed nutrition articles, dietetic publications, and RAG grounding chapters with AI semantic vector matching.

Parametry Payload (4):
query* locale ai page
200 OK • OpenSearch Specyfikacja
POST /api/v1/company JSON

Company & Dietetic Catering Directory

Explore 173,000+ verified dietary catering brands, clinics, fitness clubs, and health centers with geolocation metadata.

Parametry Payload (3):
query* locale city
200 OK • OpenSearch Specyfikacja
POST /api/v1/exercise JSON

Exercise & Biomechanics Database

Search 2,000+ strength and cardio exercises with anatomical target muscles, required equipment, and calorie burn equations.

Parametry Payload (3):
query* locale ai
200 OK • OpenSearch Specyfikacja
POST /api/v1/food JSON

Food & Nutrient Database

High-speed search across 1,900+ foods with complete macronutrients, calorie filters, micronutrients, and allergen exclusions.

Parametry Payload (7):
query* locale kcal_min / kcal_max proteins_min allergen_exclude +2
200 OK • OpenSearch Specyfikacja
POST /api/v1/medication JSON

Medication & Food-Drug Interactions

Database of 53,000+ pharmaceutical substances evaluating critical food-drug interactions, absorption interference, and nutrient depletion.

Parametry Payload (2):
query* locale
200 OK • OpenSearch Specyfikacja
POST /api/v1/recipe JSON

Recipe & Culinary Meal Database

Access 780+ chef-crafted culinary recipes with portion weights, preparation steps, and balanced macronutrient distribution.

Parametry Payload (3):
query* locale ai
200 OK • OpenSearch Specyfikacja
POST /api/v1/user JSON

Specialist & Certified Dietitian Directory

Search verified clinical nutritionists, dietitians, and personal trainers with client booking and certification data.

Parametry Payload (2):
query* locale
200 OK • OpenSearch Specyfikacja
POST /api/v1/supplement JSON

Supplement & Active Substance Database

Comprehensive dietary supplement catalog with ingredient dosages, vitamin forms, and safety recommendations.

Parametry Payload (2):
query* locale
200 OK • OpenSearch Specyfikacja
POST /api/v1/diet JSON

Clinical & Lifestyle Diet Templates (158 Types)

Official nutritionist-designed diet templates with multi-currency pricing, day duration (3-28 days), macro splits, and allergen avoidance.

Parametry Payload (8):
query diet_template_type days avoid_allergens kcal_min / kcal_max +3
200 OK • OpenSearch Specyfikacja
POST /api/v1/food-world JSON

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

Search 3.5M+ global branded products, EAN/UPC barcodes, brands, Nutri-Score, Eco-Score, and international ingredients.

Parametry Payload (6):
query barcode brand locale currency +1
200 OK • OpenSearch Specyfikacja

Zestawienie Tabelaryczne Endpointów REST API v1

/api/v1/*
Metoda & Ścieżka Zasób Dokumentacja
POST /api/v1/allergen Allergen Search & Intolerance Detection Specyfikacja →
POST /api/v1/article Article & Clinical Nutrition Guides Specyfikacja →
POST /api/v1/company Company & Dietetic Catering Directory Specyfikacja →
POST /api/v1/exercise Exercise & Biomechanics Database Specyfikacja →
POST /api/v1/food Food & Nutrient Database Specyfikacja →
POST /api/v1/medication Medication & Food-Drug Interactions Specyfikacja →
POST /api/v1/recipe Recipe & Culinary Meal Database Specyfikacja →
POST /api/v1/user Specialist & Certified Dietitian Directory Specyfikacja →
POST /api/v1/supplement Supplement & Active Substance Database Specyfikacja →
POST /api/v1/diet Clinical & Lifestyle Diet Templates (158 Types) Specyfikacja →
POST /api/v1/food-world Global Food Products & Barcodes (Open Food Facts + USDA) Specyfikacja →
response — POST /api/v1/food (JSON)
HTTP/2 200 OK 200 OK
curl -s -X POST https://www.dietspremium.com/api/v1/food -H "Content-Type: application/json" 
{
  "items": [
    {
      "id": 14,
      "name": "Pierś z kurczaka bez skóry",
      "kcal": 120,
      "proteins": 21.5,
      "fats": 1.3,
      "carbs": 0.0
    }
  ],
  "total": 1,
  "page": 1,
  "locale": "pl"
}
04 • Specyfikacja

Specyfikacja techniczna REST API

Standardy autoryzacji, stronicowania wyników oraz obsługi błędów klinicznych.

Autoryzacja nagłówkiem X-API-KEY

Każde zapytanie wymaga przekazania aktywnego klucza w nagłówku X-API-KEY lub Bearer Token.

Stronicowanie i filtrowanie wielojęzyczne

Używaj parametrów page, limit (do 100) oraz locale (pl, de, en, fr, nl, cz, at, ch, lu).

Kody odpowiedzi i limity Rate-Limit

API zwraca deterministyczne struktury JSON zgodnie z RFC 7807 Problem Details.

RestApiDataSyncAgent 200 OK

Klient synchronizacji REST API v1 i OpenSearch k-NN

HTTP/2 JSON Client
Prompt Wejściowy Agenta AI

“Pobierz niskoindeksowe przepisy kulinarne dla pacjenta i zsynchronizuj składniki z aplikacją mobilną.”

Wykorzystywane Narzędzia MCP / Endpointy
POST /api/v1/recipe POST /api/v1/food POST /api/v1/allergen POST /api/v1/diet
Ślad Wywołania (Execution Trace) 
POST https://www.dietspremium.com/api/v1/recipe (locale=pl, ai=true) → 200 OK (total: 42)

Udostępnij