Skip to main content

Gestión de Creación y Reactivación de Doctores vía API

Este endpoint permite crear doctores asociados a su Centro Médico, registrar múltiples doctores en una sola llamada a la API, o reactivar un userId que fue previamente eliminado mediante el método DELETE (teniendo en cuenta que es un soft delete).

🔒 Nota: Este recurso requiere autenticación. Consulte la sección de Autenticación para instrucciones sobre cómo obtener su token y cómo usarlo en la cabecera Authorization

Endpoint​

💡 Importante: Para conocer en detalle los métodos, parámetros requeridos, el formato del body y posibles respuestas, puede consultar la documentación específica en el Portal de desarrolladores o revisar el request configurado en el archivo de Postman previamente compartido.

🔐 Nota: Para obtener el catálogo de HealthAPI, debe autenticarse en ese mismo portal utilizando las credenciales otorgadas.

Parámetros​

ParámetroTipoObligatorioDescripción
providerIdnumberSíID del proveedor/centro médico. Este debe ser incluido en los parámetros de la ruta (path params).

Creación de un Doctor Individual​

Para crear un solo doctor, envíe un objeto JSON en el cuerpo de la solicitud.

Ejemplo de cuerpo de la solicitud (application/json):

[
  {
    "id": "",         // ID único del usuario
    "name": "",       // Nombre de usuario
    "lastname": "",   // Apellido del usuario
    "email": "",      // Correo electrónico del usuario (opcional)
    "specialityId": 1,// ID de la especialidad médica (por ejemplo, Medicina General)
    "lang": ""        // Idioma del usuario ("ES", "EN", "CA", "PT", "FR")
  }
]

Ejemplo de respuesta exitosa (201 Created):

{
  "success": true,
  "code": 201,
  "response": [
    {
      "id": "1051",
      "name": "Juan",
      "lastname": "Pérez",
      "status": "user created successfully"
    }
  ]
}

Creación de Múltiples Doctores​

Para registrar varios doctores simultáneamente, envíe un array de objetos JSON en el cuerpo de la solicitud. Cada objeto en el array representa un doctor a registrar.

Ejemplo de cuerpo de la solicitud (application/json):

[
  {
    "id": "1052",
    "name": "Lucía",
    "lastname": "Gómez",
    "email": "[email protected]",
    "specialityId": 1,
    "lang": "ES"
  },
  {
    "id": "1053",
    "name": "Marc",
    "lastname": "Dubois",
    "email": "[email protected]",
    "specialityId": 1,
    "lang": "FR"
  }
]

Ejemplo de respuesta exitosa (201 Created):

{
  "success": true,
  "code": 201,
  "response": [
    {
      "id": "1052",
      "name": "Lucía",
      "lastname": "Gómez",
      "status": "user created successfully"
    },
    {
      "id": "1053",
      "name": "Marc",
      "lastname": "Dubois",
      "status": "user created successfully"
    }
  ]
}

Reactivación de un Usuario Eliminado (Soft Delete)​

Para reactivar un userId que fue previamente eliminado mediante el método DELETE (soft delete), envíe un objeto JSON con los datos actualizados del usuario. Es crucial que el id en el cuerpo de la solicitud coincida con el id del usuario previamente eliminado.

Ejemplo de cuerpo de la solicitud (application/json):

[
  {
    "id": "1051",       // ID del usuario existente pero previamente eliminado
    "name": "new",      // Nuevo nombre de usuario
    "lastname": "new",  // Nuevo apellido
    "email": "[email protected]", // Nuevo correo electrónico (opcional)
    "specialityId": 1,  // Nueva especialidad del usuario
    "lang": "EN"        // Nuevo idioma del usuario ("ES", "EN", "CA", "PT", "FR")
  }
]

Ejemplo de respuesta exitosa (201 Created):

{
  "success": true,
  "code": 201,
  "response": [
    {
      "id": "1051",
      "name": "new",
      "lastname": "new",
      "status": "updated and reactivated userId"
    }
  ]
}

Notas sobre los Campos​

Para completar el campo specialityId, utilice el método Obtener todas las especialidades para consultar las especialidades disponibles y sus identificadores correspondientes.