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 azonosdate_fromésdate_toszü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.