Web API

Leírás

A Medio digitális klinika csomagjának részét képezik olyan API végpontok, melyekkel folyamatosan szinkronban tarthatja a weboldala és a Medio rendszerében található szakterület, szolgáltatás, orvos és intézményi adatokat.

Az API eléréséhez szükséges token generálásának feltétele a Web API szolgáltatásra való előfizetés. A tokent a https://medicall.cc/idopontfoglalas/internal/developer oldalra navigálva a Token generálása gombra kattintva kérheti le. A token minden esetben intézményhez kötött, így az csak az adott intézményt fogja autentikálni. Amennyiben több intézmény adatát szeretnénk megjeleníteni, akkor kollektor intézmény alá kell rendelni őket és a kollektor intézményhez kell tokent generálni. Ebben az esetben már a kollektor alá rendelt intézmények adataival fog visszatérni a válasz.

Visszatérési érték: 

Az API JSON formátumban ad választ a lekérdezésekre.

Autentikáció

A védett végpontok elérése sikeres autentikáció után lehetséges, melyet bearer tokennel lehet elérni, illetve a tokent query paraméterként használva.

1. A token átadása a „Authorization” fejlécben történik, a következő formában:

Authorization: Bearer <rendszer által generált token>

2. Query paraméterrel az URL-ben:

“token=<rendszer által generált token>”

Visszatérési értékek:

Sikeres autentikáció esetén a rendszer 200-as HTTP státusszal tér vissza.

Sikertelen autentikáció esetében a rendszer 401-es HTTP státusszal tér vissza.

Árlista lekérdezése

Az árlistát a token azonosítja, így a használt tokenhez tartozó minden szolgáltatás és annak ára meg fog jelenni a válaszban.

GET https://app.kvery.io/query/api/8693db85ed9/v1.0.0/pricelist

Válasz:

Példa válasz:

{
   "intezmeny_id": 20000,
   "szakterulet_id": 500000,
   "szakterulet": "Arteriográfia",
   "tipus_id": 2,
   "tipus": "Felnőtt",
   "link": "https://medicall.cc/idopontfoglalas/on-cege/specializations?qualificationId=90035"
}

Orvos lista lekérdezése

Az orvos lista elérése “szakterulet_id” paraméterhez van kötve, így könnyedén szűrhető az adott szakterületen dolgozó orvosok listája, ezáltal az adott szakterület aloldalára is könnyen beilleszthetőek az adatok, naprakész orvos információkkal.

GET https://app.kvery.io/query/api/8693db85ed9/v1.0.0/doctors

A szakterület ID akár a Medio admin felületéből, akár az árlista API-ból kinyerhető.

Így az orvoslista az alábbi képpen hívható meg:

GET https://app.kvery.io/query/api/8693db85ed9/v1.0.0/doctors?szakterulet_id=30000

Adott esetben egy orvos több intézményben is praktizálhat, így több feltöltött profilképe is lehet a rendszerben. A bearer token azonosítja az intézményt, így az API csak a lekérdezett intézményhez tartozó profilképeket fogja tartalmazni.

Válasz:

Példa válasz:

{
   "intezmeny_id": 2000000,
   "nev": "Dr. Teszt Béla",
   "profilkep":"https://demo.com/demo.jpg",
   "szakteruletek": "Allergológia, Tüdőgyógyászat",
   "bemutatkozas": "Dr. Teszt Béla vagyok csodálatos munkát végzek.",
   "beszelt_nyelvek": "HU,EN",
   "specializaciok": "<ul><li><span style='font-size: 16px'>allergiás demo</span></li><li><span style='font-size: 16px'> allergiás demo2</span></li></ul><p><br /></p>",
   "tanulmanyok": "<ul><li><span style='font-size: 16px;'>Demo iskola</span></li><li><span style='font-size: 16px'>Demo 2 iskola</span></li></ul><p><br></p>",
   "intezmenyi_hatter": "<ul><li><span style='font-size: 16px'>Demo intézmény - Demo orvos</span></li><li><span style='font-size: 16px'>Demo 2 intézmény - Demo orvos 2</span></li></ul><p><br></p>",
   "tagsagok": "<ul><li><span style='font-size: 16px'>Demo Társaság</span></li></ul>",
   "naptar_script": "<iframe src='https://medicall.cc/idopontfoglalas/doktor24/ifc2?currentInstitutionId=874&collector=1&doctorId=51619&qualificationId=90035&onlyGrouped=0&showAllSpecialization=1&simpleSelect=1' frameborder='0' width='100%' height='70px' class='medio-ifc2-iframe'></iframe><script src='https://medicall.cc/static/iframe/ifcIframe.js'></script>",
   "naptar_script_2": "<iframe src='https://medicall.cc/idopontfoglalas/doktor24/ifc2?currentInstitutionId=874&collector=1&doctorId=51619&qualificationId=90035&onlyGrouped=1&showAllSpecialization=1&simpleSelect=1' frameborder='0' width='100%' height='70px' class='medio-ifc2-iframe'></iframe><script src='https://medicall.cc/static/iframe/ifcIframe.js'></script>",
   "sorrend": 2
}

Keresés

A keresés API a megadott keresési kifejezést, a vizsgálatok nevében, az orvosok nevében, illetve a szakterületek között keresi. 

GET https://app.kvery.io/query/api/8693db85ed9/v1.0.0/search

A keresés a “q” paraméterben várja a keresni kívánt kifejezést

GET https://app.kvery.io/query/api/8693db85ed9/v1.0.0/search?q=szakorvosi+vizsgálat

Válasz:

Példa válasz:

{
   "name": "Allergológiai szakorvosi vizsgálat",
   "value": "https://medicall.cc/idopontfoglalas/systemdoctor/doctors?specializationId=79710"
}

Intézmények lekérdezése

Az intézmények API a tokennel azonosított intézmények listáját adja válaszként.

GET https://app.kvery.io/query/api/8693db85ed9/v1.0.0/institutions

Példa válasz:

{
   "intezmeny_id": 13,
   "intezmeny_nev": "MediCall Test HU",
   "varos": "Budapest"
}

Szakterületek lekérdezése

A szakterületek API a lekért intézményekhez tartozó szakterületeket adja válaszként.

GET https://app.kvery.io/query/api/8693db85ed9/v1.0.0/specializations

Az intézményt az opciónális ”intezmeny_id” paraméter segítségével adhatjuk meg, amennyiben nem adjuk meg, akkor az összes tokenhez tartozó intézmény szakterületeit adja vissza.

GET https://app.kvery.io/query/api/8693db85ed9/v1.0.0/specializations?intezmeny_id=200000

Példa válasz:

{
   "intezmeny_id": 20000,
   "szakterulet_id": 500000,
   "szakterulet": "Arteriográfia",
   "tipus_id": 2,
   "tipus": "Felnőtt",
   "link": "https://medicall.cc/idopontfoglalas/on-cege/specializations?qualificationId=90035"
}