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

Company & Dietetic Catering Directory

Locate specialized nutrition businesses, dietary meal box catering companies, sports clinics, and medical wellness facilities with precise city and geolocation filters.

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

Parametry zapytania

3 Parametr
Parametr Typ danych Wymagalność Opis parametru Przykład
query string Wymagany Company name, specialty, or city (e.g. "keto catering Munich") —
locale string Opcjonalny Target language locale en
city string Opcjonalny City or geoname filter —
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/company
terminal — POST /api/v1/company
REST HTTP/2 REQUEST
curl -X POST 'https://dietspremium.pl/api/v1/company' 
curl -X POST "https://dietspremium.pl/api/v1/company" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "query": "catering dietetyczny",
  "locale": "pl",
  "city": "Warszawa"
}'

Przykładowa odpowiedź JSON (200 OK)

HTTP/2 200 OK • application/json
response — /api/v1/company (200 OK)
JSON Payload 200 OK 
{
  "items": [
    {"id": 98, "name": "Premium Keto Catering", "city": "Warszawa", "rating": 4.9}
  ],
  "total": 1
}
Obsługa paginacji i filtrów dla /api/v1/company 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_company 200 OK

Klient HTTP dla zasobu Company & Dietetic Catering Directory

REST API v1 + OpenSearch
Prompt Wejściowy Agenta AI

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

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