Skip to main content

Crear Doctores vía API

Este endpoint permite crear doctores asociados a su Centro Médico. Puede registrar un doctor individualmente o registrar múltiples doctores en una sola llamada a la API.

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.

Endpoints de Creación​

💡 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.

A continuación se detallan los dos métodos de creación.

Creación de un Doctor Individual​

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

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

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

Respuesta exitosa (Código 200 OK):

{
    "success": true,
    "code": 201,
    "response": [
        {
            "id": "111",
            "providerId": 321
        }
    ]
}

Creación de Múltiples Doctores​

Para registrar varios doctores simultáneamente, envía un objeto JSON que contenga una clave doctors, cuyo valor será un array de objetos. Cada objeto en el array representa un doctor a registrar.

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

[
  {
    "id": "11",                       // ID único del usuario
    "name": "lucas.perez",           // Nombre de usuario
    "lastname": "Pérez",             // Apellido del usuario
    "email": "[email protected]", // Correo electrónico del usuario (opcional)
    "specialityId": 1,               // ID de la especialidad médica del usuario
    "lang": "ES"                     // Idioma del usuario ("ES", "EN", "CA", "PT", "FR")
  },
  {
    "id": "12",                       // ID único del usuario
    "name": "marie.dupont",          // Nombre de usuario
    "lastname": "Dupont",            // Apellido del usuario
    "email": "[email protected]", // Correo electrónico del usuario (opcional)
    "specialityId": 1,               // ID de la especialidad médica del usuario
    "lang": "FR"                     // Idioma del usuario ("ES", "EN", "CA", "PT", "FR")
  }
]

Respuesta exitosa (Código 200 OK):

{
    "success": true,
    "code": 201,
    "response": [
        {
            "id": "11",
            "providerId": 321
        },
        {
            "id": "12",
            "providerId": 321
        }
    ]
}

Notas sobre los Campos​

Para rellenar el campo de doctorSpeciality se debe consultar el listado de especialidades de Speaknosis para ver las especialidades disponibles y sus respectivos IDs.