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/allergen
search_allergen

Allergen Search & Intolerance Detection

Search through certified EU allergen registries, including 14 major allergens and hundreds of derivatives. Detect cross-reactivity risks, hidden allergenic traces, and sensitivity warnings.

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

Anfrageparameter

4 Parameter
Parameter Datentyp Status Beschreibung Beispiel
query string Erforderlich Allergen name or food derivative (e.g. "peanut", "histamine", "casein") —
locale string Optional Language locale (en, pl, de, fr, nl, cz, at, ch, lu) en
page integer Optional Pagination page index 1
ai boolean Optional Semantic AI query matching true
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/allergen
terminal — POST /api/v1/allergen
REST HTTP/2 REQUEST
curl -X POST 'https://www.dietspremium.com/api/v1/allergen' 
curl -X POST "https://www.dietspremium.com/api/v1/allergen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "query": "gluten",
  "locale": "en",
  "page": 1
}'

Beispiel-JSON-Antwort (200 OK)

HTTP/2 200 OK • application/json
response — /api/v1/allergen (200 OK)
JSON Payload 200 OK 
{
  "items": [
    {"id": 1, "name": "Gluten-containing cereals", "code": "GLUTEN", "severity": "HIGH"}
  ],
  "total": 1,
  "page": 1
}
Obsługa paginacji i filtrów dla /api/v1/allergen 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_allergen 200 OK

Klient HTTP dla zasobu Allergen Search & Intolerance Detection

REST API v1 + OpenSearch
Prompt Wejściowy Agenta AI

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

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

Weitere REST-API-Endpunkte

Pełny katalog REST API →
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)
POST /api/v1/food-world Global Food Products & Barcodes (Open Food Facts + USDA)

Teilen