API interfész leírás

Api interfészünk regisztrációhoz kötött és csak Business és First felhasználóknak elérhető. Business csomagban a hirdetések lekérdezése érhető el, First csomagban a teljes API felület elérhető. A lekérdező kérések beküldhetők GET vagy POST metódussal. Az adatkezelő kéréseket XML formában kell beküldeni HTTP POST formájában. A beküldött mezőértékek a következők:

• key - az irodához tartozó API kulcs. Ezt a szolgáltatótól igényelni kell. Kötelező!
• request - a kérés metódusa. Kötelező
• xml - Kötelező hirdetés feltöltésekor, vagy törlésekor.

Műveletek:

• Hirdetések lekérdezése
• Hirdetések feltöltése (új felvitel, módosítás)
• Hirdetések leállítása
• Törzsadatok lekérdezése

Hirdetések lekérdezése:

Hirdetés lekérdezésekor be kell küldeni a key és a request értéket. A request értéke ebben az esetben get_adverts. GET metódus esetén pl.: https://www.hr112.eu/api/api.hr112.php?request=get_adverts&key=f71d5ebdf687bfde6341a137b0a63069

Hirdetések feltöltése:

Hirdetés feltöltésekor XML adatot küldünk be a szerverre. A mezőértékek key, request, xml. A request ebben az esetben upload_adverts. A beküldéshez használható schema lejjebb megtalálható.

Hirdetések leállítása:

Hirdetés törlésekor XML adatot küldünk be. A mezőértékek: key, request, xml. A request ebben az esetben stop_adverts. A törléshez használt XML schema lent megtalálható.

Törzsadatok lekérdezése:

A törzsadatok lekérdezése mind GET mind POST kéréssel beküldhető. A beküldendő mezőértékek key és request. A request ebben az esetben a következő értékeket veheti fel:

• get_regions - településtörzs lekérdezése
• get_categories - kategória és alkategória törzs lekérdezése
• get_educations - elvárt végzettség törzs lekérdezése
• get_driving_licences - vezetői engedély törzs lekérdezése
• get_languages - nyelvek törzs lekérdezése
• get_competences - kompetenciák és kompetencia elemek lekérdezése
• get_employements - foglalkoztatás jellege törzs lekérdezése
• get_professional - szakmai tapasztalat törzs lekérdezése

A törzsadatok lekérdezésére azért lehet szükség, mert beküldéskor csak az ezekben található értékkészletet fogadja el rendszerünk. Minta: https://www.hr112.eu/api/api.hr112.php?request=get_regions&key=f71d5ebdf687bfde6341a137b0a63069

XML Schema

Lekérdezés

Lekérdezés esetén a rendszer válasza:

<?xml version="1.0" encoding="UTF-8"?>
<hirdeto>

<!-- A hirdető adatai-->
<nev>Borbély Péter</nev><!-- A hirdető regisztrációkor megadott neve -->
<cim>1181 Budapest Üllői út 423</cim><!-- A hirdető cég telephelye -->
<cegnev>Mintaoldal Kft</cegnev><!-- A hirdető cég neve -->
<megjeleno_cegnev>Mintaoldal Kft</megjeleno_cegnev><!-- A hirdető cég hirdetésen megjelenő neve -->
<adoszam>12238051-2-43</adoszam><!-- A hirdető cég adószáma -->
<kapcsolattarto_nev>Borbély Péter</kapcsolattarto_nev><!-- Kapcsolattartó neve -->
<kapcsolattarto_email>borbely.peter@mintaoldal.hu</kapcsolattarto_email><!-- Kapcsolattartó e-mail címe -->
<kapcsolattarto_telefon>+36301234567</kapcsolattarto_telefon><!-- Kapcsolattartó telefonszáma -->
<weboldal>https://www.mintaoldal.hu</weboldal><!-- Hirdető weboldala -->
<facebook></facebook><!-- Hirdető facebook oldala -->
<twitter></twitter><!-- Hirdető twitter oldala -->
<linkedin></linkedin><!-- Hirdető LinkedIn oldala -->
<instagram></instagram><!-- Hirdető Instagram oldala -->
<pinterest></pinterest><!-- Hirdető Pinterest oldala -->
<logo>https://www.hr112.eu/items/img/logos/129.jpg</logo><!-- Céglogó -->
<ugyintezok>
<!-- Ügyintézők listája -->
<ugyintezo>
<!-- Egy ügyintéző -->
<ugyintezo_nev>Borbély Péter</ugyintezo_nev><!-- Ügyintéző neve -->
<ugyintezo_email>borbely.peter@mintaoldal.hu</ugyintezo_email><!-- Ügyintéző e-mail címe -->
<ugyintezo_telefon></ugyintezo_telefon><!-- Ügyintéző telefonszáma -->
<ugyintezo_szerepkor>Adminisztrátor</ugyintezo_szerepkor><!-- Ügyintéző szerepköre -->
</ugyintezo>
</ugyintezok>
<hirdetesek>
<!-- Hirdetések listája -->
<hirdetes>
<!-- Egy hirdetés -->
<kod>1135</kod><!-- Hirdetés HR112 rendszerben képzett egyedi azonosítója -->
<referenciaszam>VAR-0001-129</referenciaszam><!-- Hirdetés referenciaszáma -->
<hirdeto_ceg>Mintaoldal Kft</hirdeto_ceg><!-- Hirdetéshez tartozó cég neve -->
<lejarat>2022.02.20</lejarat><!-- Hirdetés tervezett lejárata -->
<munkavegzes_helye>
<!-- Munkavégzés hlye -->
<irsz>1181</irsz><!-- Munkavégzés irányítószáma -->
<telepules>Budapest</telepules><!-- Munkavégzés települése -->
<cim>Üllői út 423</cim><!-- Munkavégzés címe -->
<toborzasi_terulet>30</toborzasi_terulet><!-- Toborzási terület -->
</munkavegzes_helye>
<megjelenes_datuma>2022.01.21</megjelenes_datuma><!-- Hirdetés első megjelenésének dátuma -->
<foglalkoztatas>Teljes munkaidő 8 óra</foglalkoztatas><!-- Foglalkoztatás jellege -->
<brutto_ber>
<!-- Bruttó bér -->
<osszeg>280000</osszeg><!-- Bruttó bér mértéke -->
<tipus>Hó</tipus><!-- Bruttó bér típusa -->
<penznem>Ft</penznem><!-- Bruttó bér pénzneme -->
</brutto_ber>
<szoveg>
<!-- Hirdetés szövege --> <![CDATA[Ez a hirdetés szövege]]>
</szoveg>
<kategoria>Hálózati és Rendszermérnök</kategoria><!-- Elsődleges kategória -->
<egyeb_kategoriak>
<!-- Egyéb kategóriák -->
<egyeb_kategoria>Információbiztonság</egyeb_kategoria><!-- Egy kategória -->
<egyeb_kategoria>Rendszergazda</egyeb_kategoria>
</egyeb_kategoriak>
<elvart_szakmai_tapasztalat>1-2 év szakmai tapasztalat</elvart_szakmai_tapasztalat><!-- Szakmai tapasztalat -->
<elvart_vegzettseg>Gimnázium</elvart_vegzettseg><!-- Végzettség -->
<munkarend>Általános</munkarend><!-- Munkarend -->
<vezetoi_engedely>B kategória</vezetoi_engedely><!-- Vezetői engedély kategória -->
<nyelvtudas>
<!-- Szükséges nyelvtudások -->
<nyelv>
<!-- Egy szükséges nyelv -->
<megnevezes>Angol</megnevezes><!-- Nyelv és elvárt szintek -->
<hallas>A1</hallas>
<olvasas>A1</olvasas>
<tarsalgas>A1</tarsalgas>
<folyamatos_beszed>A1</folyamatos_beszed>
<iras>A1</iras>
</nyelv>
</nyelvtudas>
<kompetenciak>
<!-- Szkmai és egyéb kompetenctiák -->
<informatikai_kompetenciak>
<!-- Egy kompetencia típus -->
<kompetencia_elem>Hálózatkezelés</kompetencia_elem><!-- Egy kompetencia -->
<kompetencia_elem>Operációs rendszerek</kompetencia_elem>
</informatikai_kompetenciak>
</kompetenciak>
<kapcsolat>
<!-- Kapcsolatfelvételi adatok -->
<hirdetes_email>borbely.peter@mintaoldal.hu</hirdetes_email><!-- E-mail cím -->
<hirdetes_telefon>+36301234567</hirdetes_telefon><!-- Telefonszám -->
<hivhato_idopontok>
<!-- Kapcsolatfelvételi időpontok -->
<napok>
<!-- Napok -->
<nap>Kedd</nap><!-- Egy nap -->
<nap>Szerda</nap>
</napok>
<orak>
<!-- Időpontok -->
<ora>8-12</ora><!-- Egy időpont -->
<ora>12-16</ora>
</orak>
</hivhato_idopontok>
<kapcsolat_lathato>1</kapcsolat_lathato><!-- A kapcsolatfelvételi adatok megjelenjenek-e a hirdetés adatlapján -->
</kapcsolat>
<kerdesek>
<!-- Jelenltkezőnek feltett kérdések -->
<kerdes>az otthonod és a munkahelyed között a bejárás megoldott?</kerdes><!-- Egy kérdés -->
<kerdes>elfogadható-e számodra a munkaidőkeretben történő foglalkoztatás?</kerdes>
<kerdes>rendelkezel a meghirdetett végzettséggel és jogosítvánnyal?</kerdes>
</kerdesek>
<kulso_hivatkozas></kulso_hivatkozas><!-- Jelentkezés külső hivatkozása -->
<youtube></youtube><!-- Pozíciót bemutató videó elérése -->
<image>https://www.hr112.eu/items/pozicio_images/1135/image.jpg</image><!-- A pozíció képe -->
</hirdetes>
</hirdetesek>
</hirdeto>