Tanári adatok és gépi hozzáférés

A nyilvános, csak olvasható adatforrás JavaScript, regisztráció és API-kulcs nélkül is elérhető. Hivatkozásként a magyar profil kanonikus URL-jét használd, ne az export címét.

Elérhető formátumok

Keresés és lapozás

GET /hu/directory-data/v1/teachers?page=1&limit=50
GET /hu/directory-data/v1/teachers?speciality=ielts&q=nyelvvizsga

Paraméterek: page (pozitív egész, alapérték 1), limit (1–100, alapérték 50), q (legfeljebb 160 karakter), speciality (létező, nyelvfüggetlen szakterület-azonosító). A következő oldal a next mezőben található, az utolsó oldalon null. Ismeretlen és ismételt paraméterek nem használhatók. Hibakódok: 400 érvénytelen kérés, 404 nem létező oldal, 429 túl sok kérés, 503 átmeneti hiba. Üres találati listánál az első oldal 200-as választ ad.

A mezők jelentése

A válasz version, language, canonicalOrigin, page, limit, total, pages, next és teachers mezőket tartalmaz. A profilok azonosítója (teacher:slug) megegyezik az angol változatéval. A name, url, markdownUrl, description, specialities, contactLinks, publicEmail, featured, location, availability, pricing, contentUpdatedAt és sourceVerifiedAt mezők csak nyilvános adatokat közölnek. A publicEmail csak külön engedéllyel nyilvános e-mail-címet tartalmaz. A nem ismert tények és dátumok értéke null.

A bemutatkozások tanároktól származó állítások, nem függetlenül ellenőrzött ajánlások. Az eredeti importálási forrásadatokat karbantartási célra külön őrizzük. A frissítés időpontja nem azonos a forrás ellenőrzésével. Hiányzó adatot nem szabad következtetéssel pótolni.

Kiemelés és felelős használat

A JSON-keresés csak a megadott feltételeknek megfelelő tanárokat adja vissza; a kiemelt profilok ezeken belül kerülnek előre. A látható tanárlistán a kiemelt tanár a kereséstől függetlenül is megjelenhet. A kiemelés nem minősítés. Az oldal nem igazolja a helyszínt, elérhetőséget vagy óradíjat.

A válaszokat 60 másodpercig gyorsítótárazd, feltételes kérésekhez használd az ETag/If-None-Match fejléceket. Egy kiszolgálópéldányon kapcsolati címenként legfeljebb 600 kérés/perc engedett; ez védelmi korlát, nem garantált keret. Ne indíts párhuzamos teljesadatbázis-letöltéseket. Csak GET és HEAD metódus támogatott. Az exportok noindex jelölésűek, a kanonikus profilokat indexeljék a keresők. Az elérhetőség önmagában nem ad újraközlési engedélyt a szövegekre vagy fényképekre.