Barion Pixel

Nyilvános időpontkereső – AI és webes API

A Szülni Jó! rendelő aktuális szolgáltatásai és szabad időpontjai egyszerű webes lekérdezéssel elérhetők. Nem szükséges MCP-kapcsolat, API-kulcs vagy bejelentkezés. Az AI-asszisztensnek weboldalak megnyitására vagy HTTP GET kérésekre alkalmas eszközzel kell rendelkeznie.

Webes használat, JSON nélkül

Nyisd meg a nyilvános időpontkeresőt, válassz egy szolgáltatást a „Szabad időpontok” hivatkozással, majd olvasd el az aktuális találatokat. Az oldal JavaScript nélkül is tartalmazza a szolgáltatásokat, az időpontokat és a továbbadható linkeket.

Példa: Dr. Dékány Ágnes szabad online időpontjai. Az egyes találatoknál „Az időpont továbbadható linkje” ugyanarra a szolgáltatásra, napra és időre vezet. Ezt a linket kaphatja meg a felhasználó.

1. Szolgáltatások lekérdezése

GET https://szulnijo.hu/wp-json/szulnijo-public/v1/services

Opcionális paraméter: query, legfeljebb 100 karakteres keresés a névben. A válasz services listájából választható a service_id. Minden szolgáltatáshoz tartozik search_url (ember és webes AI számára olvasható oldal) és appointments_api_url (JSON-lekérdezés).

2. Szabad időpontok lekérdezése

GET https://szulnijo.hu/wp-json/szulnijo-public/v1/appointments?service_id=wc%3A1644

  • service_id: kötelező, a szolgáltatáslistából kapott azonosító.
  • date_from, date_to: opcionális YYYY-MM-DD dátumok. Alapérték: mától 30 nap; legfeljebb 120 napra előre lehet keresni.
  • limit: 1–50, alapértéke 20. offset: 0–10000, alapértéke 0.
  • time: opcionális HH:mm idő. Egy konkrét időpont ellenőrzéséhez azonos date_from és date_to szükséges; ilyenkor lapozási paraméter nem adható meg.

A válasz appointments listájában minden találat tartalmazza az időpontot, a szakembert, a helyszínt, a foglalási módot és a share_url mezőt. A felhasználónak ezt a továbbadható URL-t érdemes visszaadni. Megnyitásakor újra lekérdezzük az elérhetőséget; ha a hely már nem szabad, ezt jelezzük.

A next_api_url és next_page_url a következő találati oldalra vezet; null esetén nincs több találat. A checked_at a friss lekérdezés ideje. Az időzóna Europe/Budapest, a megjelenített dátum YYYY.MM.DD.

Foglalás és fizetés

booking_mode=online: a WooCommerce-termékhez tartozó szolgáltatás a webshopban foglalható. Az action_url és a booking_url a termékoldalt nyitja meg. A felhasználó ott választja ki a vizsgálatot és az időpontot, majd a pénztárban fizethet, Barionnal is. A link nem választja ki automatikusan az időpontot.

booking_mode=phone: a WooCommerce-termék nélküli szolgáltatás csak telefonon foglalható. A phone telefonszámot, az action_url telefonhívási linket tartalmaz.

A lekérdezés nem hoz létre foglalást, nem tart fenn helyet, nem indít fizetést és nem kér bankkártyaadatot.

Válaszok, korlátok és adatvédelem

Sikeres kérés: HTTP 200. Üres appointments lista esetén nincs megfelelő szabad időpont. Hibás paraméter: HTTP 400. Túl sok kérés: HTTP 429, Retry-After: 60. Átmeneti hiba: HTTP 503. A hibaüzenet az error mezőben olvasható.

Az MCP és a webes kereső közös korlátja közvetlen kliens-IP-nként percenként 60 lekérdezés. A válaszok nem gyorsítótárazhatók. Betegadat, belső megjegyzés és foglalt időpont személyes adata nem kerül a nyilvános válaszba. A használati napló nem tárol IP-címet, keresőszöveget vagy teljes kérés- és választörzset.

OpenAPI 3.1 leírás · MCP-kapcsolat · Kapcsolat

Frissítve: 2026.11.16.