RECURSO DE LA API

Pacientes

Ficha del paciente: información demográfica, anamnesis/alergias, historial médico y documentos. Cada registro está aislado en su clínica; la eliminación es un archivado reversible (no hay hard-delete).

Acceso anticipado Toda la API

Endpoints

9 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 Obtiene la lista de pacientes paginada Todos los roles autorizados

POST /v1/patients Crea un nuevo registro de paciente admin · secretaria · médico

GET /v1/patients/{id} Obtiene el detalle de un solo paciente Todos los roles autorizados

PUT /v1/patients/{id} Actualiza la información del paciente admin · secretaria · médico

DELETE /v1/patients/{id} Archiva el paciente (soft-delete) admin

GET /v1/patients/{id}/medical Lista la anamnesis, las alergias y el historial médico Todos los roles autorizados

POST /v1/patients/{id}/medical Añade un registro médico/de anamnesis admin · médico

GET /v1/patients/{id}/documents Lista los documentos del paciente Todos los roles autorizados

POST /v1/patients/{id}/documents Añade un documento al paciente admin · secretaria

Ejemplo de uso

Crear nuevo paciente

Solicitud

curl -X POST https://api.udentiva.com/v1/patients \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Idempotency-Key: 9f1c2e7a-..." \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ayse","last_name":"Yilmaz","phone":"+90555..."}'

Respuesta

HTTP/1.1 201 Created
{
  "id": "c0ffee00-1234-...",
  "first_name": "Ayse",
  "last_name": "Yilmaz",
  "phone": "+90555...",
  "created_at": "2026-06-24T09:00:00Z"
}

Seguridad en este recurso

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

Aislamiento de datos: todas las consultas de pacientes están limitadas a nivel de fila (RLS) por la clínica a la que está vinculada la clave; nunca se devuelve el paciente de otra clínica.

Autorización basada en roles: creación/actualización por admin, secretaria o médico; eliminación solo por admin. La autorización se impone en la capa de la API.

Los datos sensibles (TCKN, datos de salud) se enmascaran y no se escriben en bruto en el registro de auditoría.

Eliminación = soft-delete (deleted_at); el registro se anonimiza, no se elimina físicamente (conforme a KVKK).

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

Citas y calendario Odontograma y Tratamiento Cobros y finanzas Inventario Imágenes 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