RECURSO DE LA API

Odontograma y Tratamiento

Odontograma FDI, catálogo de servicios/procedimientos, plan de tratamiento por fases y receta. Los estados dentales se mantienen append-only: el historial no se elimina ni se sobrescribe.

Acceso anticipado Toda la API

Endpoints

14 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}/odontogram Obtiene el odontograma FDI actual Todos los roles autorizados

POST /v1/patients/{id}/odontogram Añade un estado dental (append-only) admin · médico

GET /v1/patients/{id}/odontogram/{tooth}/history Obtiene el historial de estados de un diente Todos los roles autorizados

GET /v1/services Lista el catálogo de servicios/procedimientos Todos los roles autorizados

POST /v1/services Añade una línea de servicio admin

PUT /v1/services/{id} Actualiza la línea de servicio admin

GET /v1/patients/{id}/plans Lista los planes de tratamiento del paciente Todos los roles autorizados

POST /v1/patients/{id}/plans Crea un plan de tratamiento admin · médico

GET /v1/plans/{id} Obtiene el detalle del plan de tratamiento Todos los roles autorizados

POST /v1/plans/{id}/status Cambia el estado del plan admin · médico

POST /v1/plans/{id}/items Añade una fase/línea al plan admin · médico

POST /v1/plan-items/{id}/status Cambia el estado de la línea del plan admin · médico

GET /v1/patients/{id}/prescriptions Lista las recetas Todos los roles autorizados

POST /v1/patients/{id}/prescriptions Crea una receta admin · médico

Ejemplo de uso

Añadir estado dental (append-only)

Solicitud

curl -X POST https://api.udentiva.com/v1/patients/{id}/odontogram \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tooth":"11","state":"caries","surface":"mesial"}'

Respuesta

HTTP/1.1 201 Created
{
  "id": "st-77",
  "tooth": "11",
  "state": "caries",
  "recorded_at": "2026-06-24T09:10:00Z"
}

Seguridad en este recurso

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

Los registros de estado dental son append-only: cada cambio se añade como una nueva fila, el registro anterior no puede modificarse (integridad del historial clínico).

La creación de plan de tratamiento y receta está disponible solo para los roles admin/médico; la lógica de precio y de fases se ejecuta en el servidor.

Todos los registros están aislados en su clínica; los cálculos de precio del plan no se toman del cliente, se hacen en el servidor con numeric.

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