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/article
search_article

Article & Clinical Nutrition Guides

Retrieve evidence-based dietetic publications, peer-reviewed clinical summaries, and authoritative medical research. Designed for AI grounding, reference lookups, and patient education.

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

Parametry zapytania

4 Parametr
Parametr Typ danych Wymagalność Opis parametru Przykład
query string Wymagany Search term or medical inquiry (e.g. "insulin resistance diet") —
locale string Opcjonalny Target language locale en
ai boolean Opcjonalny Semantic AI search enabled true
page integer Opcjonalny Pagination 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/article
terminal — POST /api/v1/article
REST HTTP/2 REQUEST
curl -X POST 'https://www.dietspremium.com/api/v1/article' 
curl -X POST "https://www.dietspremium.com/api/v1/article" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "query": "insulin resistance diet",
  "locale": "en",
  "ai": true,
  "page": 1
}'

Przykładowa odpowiedź JSON (200 OK)

HTTP/2 200 OK • application/json
response — /api/v1/article (200 OK)
JSON Payload 200 OK 
{
  "items": [
    {"id": 412, "title": "Insulin Resistance & Low GI Diets", "slug": "insulin-resistance-diet", "readingTime": 6}
  ],
  "total": 12,
  "page": 1
}
Obsługa paginacji i filtrów dla /api/v1/article 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_article 200 OK

Klient HTTP dla zasobu Article & Clinical Nutrition Guides

REST API v1 + OpenSearch
Prompt Wejściowy Agenta AI

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

Wykorzystywane Narzędzia MCP / Endpointy
POST /api/v1/article
Ślad Wywołania (Execution Trace) 
→ POST /api/v1/article (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/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)

Udostępnij