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.
- Pasando el token al “Autorización”encabezado, de la siguiente forma:
Autorización: Portador
- Con parámetro de consulta en la URL:
“ficha="
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:
| id_institución | número | El identificador único de la institución. |
| id_profesional | número | Identificador único de la especialidad |
| Especialización | cadena | El campo de estudio |
| sulo_szolgaltatas_id | número | nulo | Identificador único del servicio principal. |
| sulo_servicio | cadena | nulo | Servicio para padres |
| servicio | cadena | El nombre de la prueba. |
| min_ar | número | El precio mínimo de la prueba. |
| max_ar | número | El precio máximo de la prueba. |
| tipo_id | número | Identificador único del tipo de prueba. |
| tipo | cadena | El tipo de examen |
| enlace | cadena | Enlace de reserva para la prueba |
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:
| id_institución | número | El identificador único de la institución. |
| nombre | cadena | el nombre del medico |
| foto de perfil | cadena | La URL de la foto de perfil del médico. |
| áreas especializadas | cadena | Especializaciones realizadas por un médico. |
| introducción | cadena | Introducción del médico. |
| lenguajes hablados | cadena | Los idiomas hablados por el médico. |
| especializaciones | cadena | Especializaciones del médico (lista HTML) |
| estudios | cadena | Estudios de doctorado (lista HTML) |
| institución_hatter | cadena | Las (antiguas) instituciones del médico (lista HTML) |
| miembros | cadena | Membresías del médico (lista HTML) |
| calendario_script | cadena | El calendario del médico (iframe) |
| calendario_script_2 | cadena | El calendario del médico (iframe) |
| secuencia | número | orden medica |
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:
| nombre | cadena | El nombre de los estudios que contienen el término de búsqueda. |
| valor | cadena | La URL de reserva de las pruebas que contienen el término de búsqueda. |
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
| id_institución | número | El identificador único de la institución perteneciente al token. |
| Nombre de la Institución | cadena | El nombre de la institución perteneciente al token. |
| ciudad | cadena | La ciudad de la institución perteneciente al token. |
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
| id_institución | número | El identificador único de la institución solicitada. |
| id_profesional | número | El identificador único de la especialidad enumerada. |
| Especialización | cadena | El nombre del campo de especialización perteneciente a la institución solicitada. |
| tipo_id | número | Identificador único del tipo para el campo de especialización. |
| tipo | cadena | tipo de especialidad |
| enlace | cadena | La URL de reserva del dominio. |
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" }