Web-API

Beschreibung

Das digitale Klinikpaket von Medio enthält API-Endpunkte, um Ihre Website und die Fachgebiets-, Dienstleistungs-, Arzt- und Institutionsdaten im Medio-System synchron zu halten.

Um ein Token für den Zugriff auf die API zu generieren, müssen Sie den Web-API-Dienst abonnieren. Das Token wird erzeugt durch https://medicall.cc/idopontfoglalas/internal/developer Seite, indem Sie auf die Schaltfläche Token generieren klicken. Das Token ist immer mit einer Einrichtung verknüpft, so dass es nur diese Einrichtung authentifiziert. Wenn Sie Daten von mehreren Einrichtungen anzeigen möchten, müssen Sie diese einer Sammeleinrichtung zuordnen und ein Token für die Sammeleinrichtung erzeugen. In diesem Fall wird die Antwort mit den Daten der Einrichtungen zurückgegeben, die dem Collector zugeordnet sind.

Rückgabewert: 

Die API liefert Antworten auf Abfragen im JSON-Format.

Authentifizierung

Auf geschützte Endpunkte kann nach erfolgreicher Authentifizierung zugegriffen werden, die durch ein Inhaber-Token oder durch die Verwendung des Tokens als Abfrageparameter erreicht werden kann.

1. Übertragen Sie das Token mit dem "AutorisierungHeader" in folgendem Format:

Berechtigung: Inhaber

2. Abfrageparameter in der URL:

"token=<rendszer által generált token>"

Rückgabewerte:

Wenn die Authentifizierung erfolgreich war, gibt das System den HTTP-Status 200 zurück.

Wenn die Authentifizierung nicht erfolgreich ist, gibt das System den HTTP-Status 401 aus.

Preisliste anfordern

Die Preisliste wird durch das Token identifiziert, so dass alle Dienste und ihre Preise für das verwendete Token in der Antwort angezeigt werden.

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

Antwort:

Beispielantwort:

{
   "intezmeny_id": 20000,
   "szakterulet_id": 500000,
   "Spezialität": "Arteriographie",
   "typus_id": 2,
   "typus": "Erwachsener",
   "link": "https://medicall.cc/idopontfoglalas/on-cege/specializations?qualificationId=90035"
}

Abfrage einer Liste von Ärzten

Zugang zur Ärzteliste "spezialität_id" ist mit einem Parameter verknüpft, so dass es einfach ist, die Liste der in einem bestimmten Fachgebiet tätigen Ärzte zu filtern, und so können die Daten leicht in die Unterseite des Fachgebiets mit aktuellen Arztinformationen eingefügt werden.

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

Die Spezialitäten-ID kann entweder über die Medio-Verwaltungsoberfläche oder über die Preislisten-API abgerufen werden.

So kann die Liste der Ärzte wie folgt aufgerufen werden:

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

In einigen Fällen kann ein Arzt in mehr als einer Einrichtung praktizieren, so dass er oder sie mehrere hochgeladene Profile im System haben kann. Das Inhaber-Token identifiziert die Einrichtung, so dass die API nur die Profilbilder für die abgefragte Einrichtung enthält.

Antwort:

Beispielantwort:

{
    "intezmeny_id": 2000000,
    "nev": "Dr. Teszt B\u00e9la",
    "profilkep": "https:\/\/demo.com\/demo.jpg",
    "szakteruletek": "Allergol\u00f3gia, T\u00fcd\u0151gy\u00f3gy\u00e1szat",
    "bemutatkozas": "Dr. Teszt B\u00e9la vagyok csod\u00e1latos munk\u00e1t v\u00e9gzek.",
    "beszelt_nyelvek": "HU,EN",
    "specializaciok": "<ul><li><span style='font-size: 16px'>Allergie-Demo<\/span><\/li><li><span style='font-size: 16px'>\u00a0allergisch demo2<\/span><\/li><\/ul><p><br \/><\/p>",
    "tanulmanyok": "<ul><li><span style='font-size: 16px;'>Demo-Schule<\/span><\/li><li><span style='font-size: 16px'>Demo 2 Schule<\/span><\/li><\/ul><p><br><\/p>",
    "intezmenyi_hatter": "<ul><li><span style='font-size: 16px'>Demo-Einrichtung - Demo-Arzt<\/span><\/li><li><span style='font-size: 16px'>Demo 2 Einrichtung - Demo Arzt 2<\/span><\/li><\/ul><p><br><\/p>",
    "tagsagok": "<ul><li><span style='font-size: 16px'>Demo Unternehmen<\/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
}

Suche unter

Die Such-API sucht nach dem von Ihnen angegebenen Suchbegriff, im Namen von Studien, im Namen von Ärzten oder nach Fachgebiet. 

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

Die Suche wartet auf den zu suchenden Begriff im Parameter "q".

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

Antwort:

Beispielantwort:

{
   "Name": "Facharztprüfung Allergologie",
   "value": "https://medicall.cc/idopontfoglalas/systemdoctor/doctors?specializationId=79710"
}

Abfrage von Institutionen

Die API "Institutionen" gibt eine Liste der Institutionen zurück, die durch das Token identifiziert werden.

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

Beispielantwort:

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

Spezialisierung der Abfrage

Die Fachgebiete-API gibt die Fachgebiete der in der Antwort konsultierten Einrichtungen an.

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

Die Einrichtung kann mit dem optionalen Parameter "intezmeny_id" angegeben werden; wird dieser nicht angegeben, werden die Spezialisierungen aller mit dem Token verbundenen Einrichtungen zurückgegeben.

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

Beispielantwort:

{
   "intezmeny_id": 20000,
   "szakterulet_id": 500000,
   "Spezialität": "Arteriographie",
   "typus_id": 2,
   "typus": "Erwachsener",
   "link": "https://medicall.cc/idopontfoglalas/on-cege/specializations?qualificationId=90035"
}