Empezando

Primer portal para desarrolladores de API de interoperabilidad médica

El primer portal para desarrolladores de API de interoperabilidad médica proporciona desarrolladores de aplicaciones con acceso a documentación, servicios de registro, Servicios de entorno de pruebas para desarrolladores y otros servicios para desarrolladores relacionados con la aplicación interfaces de programación ("API") proporcionadas por First Medical. Primera Salud Médica y de Innovación, de conformidad con los Centros de Servicios de Medicare y Medicaid ("CMS") Interoperabilidad y Norma definitiva de acceso del paciente (CMS-9115-F).

Nuestros servicios están en vivo
  • La API de acceso al paciente permitirá a los desarrolladores recuperar, con la aprobación y bajo la dirección de un afiliado aplicable de First Medical o el representante personal del afiliado, ciertos datos, según corresponda, con respecto a reclamaciones adjudicadas, datos de encuentro de proveedores capitados, datos del formulario y ciertos datos clínicos, si First Medical mantiene dichos datos.
  • La API del directorio de proveedores permitirá a los desarrolladores recuperar, según corresponda, cierta información del directorio de farmacias y proveedores de First Medical.
  • Developer Sandbox permitirá a los desarrolladores probar sus aplicaciones conexión a las API sin establecer acceso de producción a las API.
Registrarse como desarrolladora para First Medical APIs

Cómo crear una cuenta para utilizar el portal para desarrolladores de API de interoperabilidad de First Medical si es DESARROLLADOR:

  • Hacer clic aquí para registrarse
  • Ingrese su dirección de correo electrónico y su nombre y apellido.
  • First Medical le enviará un código de seguridad a su dirección de correo electrónico. Revise su correo electrónico e ingrese el código. El código caducará después de 5 minutos.
  • Ingrese su nombre, apellido y segundo apellido.
  • Acepte los Términos y condiciones y haga clic en Registrarse.
  • First Medical enviará una OTP a la Id. De correo electrónico ingresada.
  • Verifique su correo electrónico (la OTP será válida por 5 minutos), ingrese la OTP y haga clic en Confirmar OTP.
  • Una vez que haga clic en Confirmar OTP, puede registrar una aplicación.
  • Una vez registrado, el administrador lo aprobará y, una vez aprobado, podrá acceder a nuestras API de producción.
Suscripción a las primeras API médicas
  • Haga clic en Registro de la aplicación, ahora ingrese toda la información en Información de la aplicación.
  • Cree una nueva aplicación que incluya el nombre de la aplicación y la URL de devolución de llamada y envíela.
  • El sistema generará una identificación de cliente y una clave secreta. Es importante que guarde el ID de cliente y clave secreta que se utilizarán en el proceso. Solo se le mostrará una vez.
  • Haga clic en Mis aplicaciones nuevamente y haga clic en actualizar para ver su nueva aplicación.
  • Dentro de la aplicación, puede ver su ID de cliente, Suscripciones, Actualización de la aplicación y Productos API.
  • La actualización de la aplicación permite a los usuarios cambiar la URL de devolución de llamada, eliminar la aplicación, Restablezca la identificación del cliente y la clave secreta (en caso de que haya olvidado escribirlas) y verifique la identificación del cliente y la clave secreta. Verificar la identificación del cliente y la clave secreta puede ser útil si ha creado varias aplicaciones. y han confundido qué ID de cliente y clave secreta se aplica a qué aplicación.
Prueba la API

Requisitos previos:- El registro de desarrollador es obligatorio.

Paso 1:
  • Después de registrarse como Desarrollador, el Desarrollador puede registrar su aplicación.
  • Haga clic en "Registro de la aplicación" para registrar su aplicación y obtener una identificación de cliente y una clave secreta de cliente.
  • Asegúrese de guardar la clave secreta del cliente, que es necesaria para generar un código de respuesta o un token.
Paso 2:

Hay dos formas de integrar la plataforma Autenticación con First Medical para obtener los datos del paciente registrado.

1. Flujo de autenticación web

Este es un flujo más seguro y recomendado porque la identificación del cliente y la clave secreta del cliente se validan mientras se genera un token.

  • Para usar este flujo, su aplicación debe estar registrada con el Tipo de cliente configurado en Confidencial y el tipo de concesión establecido en Código de Autorización.
  • Se ejecutan los siguientes pasos para autenticar al usuario:-
  • Solicite autorización desde la URL de la aplicación:- https://app-alpss-oauthprovider-dev-001.azurewebsites.net/v1/o/authorizeSandbox/?client_id=client_Id&redirect_uri=redirect_uri&response_type=response_type&state=state
    • client_Id:- Se generará cuando el Desarrollador registre la Aplicación.
    • redirect_uri:- El desarrollador necesita guardar durante el registro de la aplicación.
    • response_type:- código (para lograr este flujo, debe establecerse como "código")
    • estado:- Alfabeto de cualquier carácter aleatorio (Opcional) (Longitud = 15 y Formato = Alfanumérico)
  • Una vez que la aplicación navegue a la URL anterior con la información requerida, se adjuntará el código de respuesta para redireccionar la URL según el formato siguiente:

    your_application_redirect_URL ? código = código your_application_redirect_URL:- este es el código URL de redireccionamiento de su aplicación
    registrada:- Se generará y enviará desde la plataforma First Medical.
    Ejemplo:- http://localhost:8080/testclient/callback?responseCode=eiugferui

    Su aplicación ahora puede intercambiar el "código" proporcionado con la URL redirigida por un token.
  • Envíe una solicitud POST al punto final del token de la plataforma First Medical proporcionando el responseCode, clientSecret, redirectUri y grantType.
  • Encuentre a continuación la URL y el formato para generar el token.
    https://func-alpss-oauthprovider-dev-001.azurewebsites.net/api/token
    Pase los siguientes datos en los encabezados.
    • responseCode:- El flujo de autenticación generará el código de respuesta
    • grantType:- Authorization_code
    • clientSecret:- se generará mientras el desarrollador está registrando la aplicación
    • redirectUri:- URI de redireccionamiento de la aplicación registrada
    • Alcance:-
      • Alcance Nombres de alcance
      Patient patient/Patient.read
      Explanation of Benefit patient/ExplanationOfBenefit.read
      Cobertura patient/Coverage.read
      Profile profile
  • Respuesta:- ("token" : token JWT generado) La plataforma First Medical validará la información anterior. En validaciones exitosas, se generará el token JWT para su uso posterior.
2. Flujo de autenticación del cliente
¿Quiere utilizar el entorno Sandbox?

Siga los pasos a continuación:

  • Haga clic en el enlace en API y Swagger Files y use las credenciales mencionadas para Iniciar sesión.
  • Una vez ingresados el nombre de usuario y la contraseña, haga clic en Iniciar sesión y generará su token de Sandbox.
  • Copie el token y utilícelo para probar datos de muestra y haga clic en Probar.
  • Una vez que haga clic en Probar, podrá acceder a los datos de muestra.
  • Seleccione la API, por ejemplo, Paciente.
  • Haga clic en Pruébelo y escriba el token de portador.
  • Utilice 'Portador' antes de pegar el token y haga clic en Ejecutar.
  • Revise las respuestas.
Paso 3:

Llamar a la API

  • Pruebe esto en su API: después de generar el token JWT, vaya a la biblioteca de API y haga clic en la columna Más detalles, luego abrirá la URL de First Medical Swagger. Aquí, puede acceder a cualquier nodo, obtendrá los datos de muestra relacionados con sus perfiles.
API y archivos Swagger
  • Para obtener más información sobre las API disponibles, consulte la. Biblioteca de API
  • Hacer clic aquí para acceder al perfil de la zona de pruebas para ver los datos de muestra. Para acceder al perfil de la zona de pruebas, utilice las siguientes credenciales:
    • Nombre de usuario:- sandbox@mail.com
    • Contraseña:- admin@123