Listar profesionales reservables

GET/practitioners

Lista profesionales activos del tenant autenticado. Puede filtrar por servicio y sede; los arreglos retornados contienen exclusivamente relaciones activas utilizables por SAH.

Ejemplo de solicitud:Shell / cURLJavaScriptPython / requestsPHP / cURLC# / HttpClient

curl --request GET \
  --url '${BASE_URL}/practitioners' \
  --header 'Authorization: Bearer ${ACCESS_TOKEN}' \
  --data-urlencode 'serviceId=22000000-0000-4000-8000-000000000004'

Request

Headers y parametros

Nombre	Ubicacion	Requerido	Descripcion
X-Correlation-Id	header	No	UUID generado por el consumidor para trazabilidad; el servidor genera uno si se omite.
serviceId	query	No	Tipo de cita contratado que debe atender el profesional.
locationId	query	No	Sede activa asociada al profesional.
cursor	query	No	Cursor opaco retornado por la pagina anterior; no debe interpretarse.
limit	query	No	Cantidad maxima de elementos solicitados.

Responses

200Pagina estable de profesionales reservables.

Content-Type: application/json

Campo	Tipo	Requerido	Descripcion
items	object[]	Si	-
nextCursor	string | null	Si	-

Ejemplo

ejemplo de respuesta 200

{
  "items": [
    {
      "code": "ANA-TORRES",
      "fullName": "Dra. Ana Torres",
      "id": "22000000-0000-4000-8000-000000000002",
      "locationIds": [
        "22000000-0000-4000-8000-000000000001"
      ],
      "serviceIds": [
        "22000000-0000-4000-8000-000000000004"
      ],
      "specialtyIds": [
        "22000000-0000-4000-8000-000000000003"
      ]
    }
  ],
  "nextCursor": null
}

400Solicitud mal formada o parametro invalido.

Content-Type: application/problem+json

Campo	Tipo	Requerido	Descripcion
code	string	Si	-
correlationId	string (uuid)	Si	-
detail	string	No	Explicacion segura sin PII ni secretos.
errors	object[]	No	-
instance	string (uri-reference)	No	-
status	integer	Si	-
title	string	Si	-
type	string (uri)	Si	URI estable que identifica la clase de problema.

Ejemplo

ejemplo de respuesta 400

{
  "code": "INVALID_REQUEST",
  "correlationId": "10000000-0000-4000-8000-000000000001",
  "detail": "Revise los parametros enviados.",
  "status": 400,
  "title": "Solicitud invalida",
  "type": "https://magnosoft.com.co/problems/invalid-request"
}

401Token ausente, invalido, vencido o con audience incorrecta.

Content-Type: application/problem+json

Campo	Tipo	Requerido	Descripcion
code	string	Si	-
correlationId	string (uuid)	Si	-
detail	string	No	Explicacion segura sin PII ni secretos.
errors	object[]	No	-
instance	string (uri-reference)	No	-
status	integer	Si	-
title	string	Si	-
type	string (uri)	Si	URI estable que identifica la clase de problema.

Ejemplo

ejemplo de respuesta 401

{
  "code": "INVALID_ACCESS_TOKEN",
  "correlationId": "10000000-0000-4000-8000-000000000001",
  "status": 401,
  "title": "Autenticacion requerida",
  "type": "https://magnosoft.com.co/problems/unauthorized"
}

403Service principal autenticado sin el scope requerido.

Content-Type: application/problem+json

Campo	Tipo	Requerido	Descripcion
code	string	Si	-
correlationId	string (uuid)	Si	-
detail	string	No	Explicacion segura sin PII ni secretos.
errors	object[]	No	-
instance	string (uri-reference)	No	-
status	integer	Si	-
title	string	Si	-
type	string (uri)	Si	URI estable que identifica la clase de problema.

Ejemplo

ejemplo de respuesta 403

{
  "code": "INSUFFICIENT_SCOPE",
  "correlationId": "10000000-0000-4000-8000-000000000001",
  "status": 403,
  "title": "Permiso insuficiente",
  "type": "https://magnosoft.com.co/problems/forbidden"
}

429Limite de solicitudes excedido para el service principal.

Content-Type: application/problem+json

Campo	Tipo	Requerido	Descripcion
code	string	Si	-
correlationId	string (uuid)	Si	-
detail	string	No	Explicacion segura sin PII ni secretos.
errors	object[]	No	-
instance	string (uri-reference)	No	-
status	integer	Si	-
title	string	Si	-
type	string (uri)	Si	URI estable que identifica la clase de problema.

Ejemplo

ejemplo de respuesta 429

{
  "code": "RATE_LIMIT_EXCEEDED",
  "correlationId": "10000000-0000-4000-8000-000000000001",
  "status": 429,
  "title": "Demasiadas solicitudes",
  "type": "https://magnosoft.com.co/problems/rate-limit"
}