API web

Descripción

El paquete de clínica digital de Medio incluye puntos finales API con los que puede mantener constantemente sincronizados su sitio web y los datos de especialidad, servicio, médico e institucional en el sistema de Medio.

Para generar el token necesario para acceder a la API, debe suscribirse al servicio Web API. El token es emitido por https://medicall.cc/idopontfoglalas/internal/developer página, puede solicitarlo haciendo clic en el botón Generar token. En todos los casos, el token está vinculado a una institución, por lo que solo autenticará la institución determinada. Si queremos mostrar los datos de varias instituciones, se deben asignar a la institución recolectora y se debe generar un token para la institución recolectora. En este caso la respuesta regresará con los datos de las instituciones asignadas al recolector.

Valor de retorno: 

La API responde a consultas en formato JSON.

Autenticación

El acceso a los puntos finales protegidos es posible después de una autenticación exitosa, lo que se puede lograr con un token de portador o utilizando el token como parámetro de consulta.

1. Pasando el token al “Autorización”encabezado, de la siguiente forma:

Autorización: Portador

2. Con parámetro de consulta en la URL:

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

Valores de retorno:

En caso de autenticación exitosa, el sistema regresa con un estado HTTP de 200.

En caso de autenticación fallida, el sistema regresa con el estado HTTP 401.

Consultar lista de precios

La lista de precios se identifica por el token, por lo que en la respuesta aparecerán todos los servicios asociados al token utilizado y su precio.

OBTÉN https://app.kvery.io/query/api/8693db85ed9/v1.0.0/pricelist

Respuesta:

Respuesta de ejemplo:

{ "institution_id": 20000, "specialty_id": 500000, "szakterulet": "Arteriografía", "type_id": 2, "type": "Adulto", "link": "https://medicall.cc/idopontfoglalas/ on-cege/especializaciones?qualificationId=90035" }

Consulta de lista de médicos.

Accediendo a la lista de médicos "id_especialista" está vinculado a un parámetro, por lo que la lista de médicos que trabajan en la especialidad determinada se puede filtrar fácilmente, por lo que los datos también se pueden insertar fácilmente en la subpágina de la especialidad determinada, con información médica actualizada.

OBTÉN https://app.kvery.io/query/api/8693db85ed9/v1.0.0/doctors

El ID del campo se puede obtener desde la interfaz de administración de Medio o desde la API de la lista de precios.

Así, la lista de médicos se puede convocar de la siguiente manera:

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

En los casos apropiados, un médico puede ejercer en varias instituciones, por lo que puede tener varias fotografías de perfil cargadas en el sistema. El token de portador identifica a la institución, por lo que la API solo contendrá imágenes de perfil que pertenecen a la institución consultada.

Respuesta:

Respuesta de ejemplo:

{
    "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'>demostraci\u00f3n de alergia<\/span><\/li><li><span style='font-size: 16px'>\u00a0demostraci\u00f3n de alergia2<\/span><\/li><\/ul><p><br \/><\/p>",
    "tanulmanyok": "<ul><li><span style='font-size: 16px;'>escuela de demostraci\u00f3n<\/span><\/li><li><span style='font-size: 16px'>Demostraci\u00f3n 2 escuelas<\/span><\/li><\/ul><p><br><\/p>",
    "intezmenyi_hatter": "<ul><li><span style='font-size: 16px'>Instituci\u00f3n de demostraci\u00f3n - M\u00e9dico de demostraci\u00f3n<\/span><\/li><li><span style='font-size: 16px'>Demo 2 instituciones - Demo doctor 2<\/span><\/li><\/ul><p><br><\/p>",
    "tagsagok": "<ul><li><span style='font-size: 16px'>Empresa de demostraci\u00f3n<\/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
}

Buscar

La API de búsqueda busca el término de búsqueda especificado, en nombre de exámenes, en nombre de médicos y entre especialidades. 

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

La búsqueda espera el término de búsqueda en el parámetro "q"

OBTÉN https://app.kvery.io/query/api/8693db85ed9/v1.0.0/search?q=specialist+examination

Respuesta:

Respuesta de ejemplo:

{ "nombre": "Examen del especialista en alergología", "valor": "https://medicall.cc/idopontfoglalas/systemdoctor/doctors?specializationId=79710" }

Consulta de instituciones

La API de instituciones devuelve una lista de instituciones identificadas por el token.

OBTÉN https://app.kvery.io/query/api/8693db85ed9/v1.0.0/institutions

Respuesta de ejemplo:

{ "institution_id": 13, "institution_name": "MediCall Test HU", "varos": "Budapest" }

Consulta de campos de especialización.

La API de especializaciones proporciona como respuesta las especializaciones pertenecientes a las instituciones solicitadas.

OBTÉN https://app.kvery.io/query/api/8693db85ed9/v1.0.0/specializations

La institución se puede especificar usando el parámetro opcional "institution_id", si no se especifica, devuelve las especialidades de todas las instituciones que pertenecen al token.

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

Respuesta de ejemplo:

{ "institution_id": 20000, "specialty_id": 500000, "szakterulet": "Arteriografía", "type_id": 2, "type": "Adulto", "link": "https://medicall.cc/idopontfoglalas/ on-cege/especializaciones?qualificationId=90035" }