RECURSO DE LA API

Imágenes

Las radiografías y las fotografías clínicas se vinculan a la ficha del paciente. Los archivos se almacenan en un object storage compatible con S3; nunca en la base de datos.

Acceso anticipado Toda la API

Endpoints

3 endpoint

Endpoints de este recurso. Cada endpoint se limita a los datos de la clínica a la que está vinculada la clave de la API; los endpoints de escritura admiten la cabecera Idempotency-Key.

GET /v1/patients/{id}/images Lista las imágenes del paciente (radiografía/foto) Todos los roles autorizados

POST /v1/patients/{id}/images Sube una imagen (S3, stream/presigned) admin · médico · secretaria

GET /v1/images/{id}/raw Descarga el archivo de imagen (presigned) Todos los roles autorizados

Ejemplo de uso

Listar las imágenes del paciente

Solicitud

curl https://api.udentiva.com/v1/patients/{id}/images \
  -H "Authorization: Bearer udk_live_xxx"

Respuesta

HTTP/1.1 200 OK
[
  {
    "id": "img-55",
    "kind": "panoramic",
    "url": "https://s3.../signed?expires=...",
    "created_at": "2026-06-24T09:20:00Z"
  }
]

Seguridad en este recurso

La seguridad no es una función, es la propia arquitectura. Las garantías vigentes en este recurso:

Los archivos grandes (radiografías) no se escriben en el disco del BFF; van directamente a S3 mediante stream/presigned.

El acceso al archivo bruto se otorga mediante un enlace firmado de duración limitada (presigned); aunque el enlace se filtre, expira.

Todas las imágenes están aisladas por paciente y por clínica (RLS); ninguna clínica no autorizada puede acceder.

Todo el modelo de seguridad →

Formato de error

Los errores se devuelven con un sobre coherente; el código va dirigido a la máquina, el mensaje al usuario. El error interno o el stack nunca se filtran.

{
  "error": {
    "code": "validation_failed",
    "message": "Campo no válido: correo electrónico"
  }
}

Otros recursos

Pacientes Citas y calendario Odontograma y Tratamiento Cobros y finanzas Inventario Laboratorio Lead y CRM Turismo de salud Informes y BI Webhooks Transferencia de Datos (Export API)

¿Quiere acceso anticipado?

Sea el primero en enterarse cuando se abra la API.

Contactar