> ## Documentation Index
> Fetch the complete documentation index at: https://omniloy.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API de Codificación

> Visión General

La API Codify de Omniscribe **proporciona codificación médica ICD-10 impulsada por IA** desde notas clínicas, **con una precisión superior en un 77% a los LLMs generales**.

**En términos simples**: envía una nota clínica (texto o PDF), y la API devuelve evaluaciones estructuradas de códigos ICD-10 con puntuaciones de confianza, justificaciones y análisis detallado del proceso de decisión de la IA.

## ¿Por qué somos diferentes?

A diferencia de LLMs genéricos (ChatGPT, Claude, etc.), utilizamos **modelos especializados entrenados específicamente para codificación clínica**, logrando:

* 77% más de precisión que LLMs generales en codificación CIE-10.
* Reducción del 92% en alucinaciones médicas.
* Adaptación a tu centro: Modelos personalizados con tus nomenclaturas y flujos.
* Multilingüe real: Entrenados en español clínico, catalán, euskera, gallego e inglés.

## ¿Para que sirve?

Esta API resuelve problemas críticos de documentación clínica:

### Codificación Médica ICD-10

* **Extracción automática de códigos ICD-10** desde notas clínicas con análisis impulsado por IA.
* **Puntuaciones de confianza** para cada código (0-100%) para apoyar decisiones de codificación.
* **Justificaciones detalladas** explicando por qué se seleccionó cada código.
* **Análisis de códigos descartados** mostrando códigos rechazados y razonamiento.
* **ROI medible**: Reducción del 70% del tiempo de codificación.

### Facturación y Cumplimiento

* **Asignaciones precisas de códigos** para reembolsos.
* **Pista de auditoría** con seguimiento run\_id para cada sesión de codificación.
* **Seguimiento de doctor y paciente** para cumplimiento normativo.
* **Aseguramiento de calidad** mediante toma de decisiones transparente de la IA.

### Listo para Integración

* **Soporte PDF** para procesar documentos escaneados (hasta 5MB).
* **Entrada de texto** para integración directa con EHR (hasta 50KB).
* **Selección de modelos de IA personalizados** para necesidades especializadas.
* **API RESTful** con manejo consistente de errores.

## ¿Cómo funciona el proceso?

### Paso 1: Prepare su nota clínica

Prepare su nota clínica como:

* **Texto plano** (hasta 50KB) - desde EHR, dictado o entrada manual
* **Archivo PDF** (hasta 5MB decodificado) - documentos escaneados o informes

Opcionalmente, especifique un modelo de IA personalizado para necesidades de procesamiento especializadas.

### Paso 2: Envíe a la API Codify

Envíe su nota clínica a `/v1/codify` con headers opcionales de seguimiento para fines de auditoría.

**Nuestro motor de IA clínica especializado**:

1. Analiza el contexto médico usando modelos entrenados en millones de notas clínicas reales.
2. Identifica diagnósticos y condiciones médicas con alta precisión.
3. Asigna códigos ICD-10 apropiados con puntuaciones de confianza.
4. Proporciona justificaciones detalladas para cada selección de código.
5. Muestra códigos descartados y por qué fueron rechazados.

### Paso 3: Reciba evaluaciones de códigos ICD-10

La API devuelve:

* **Evaluaciones de códigos finales**: Códigos ICD-10 seleccionados con descripciones, justificaciones y puntuaciones de confianza
* **Evaluaciones descartadas**: Códigos rechazados mostrando el proceso de decisión de la IA
* **Run ID**: Identificador único para seguimiento y depuración

<Steps>
  <Step title="Entrada clínica">
    Envíe su nota clínica como **texto o PDF** a la API.
  </Step>

  <Step title="Análisis IA">
    El **Motor IA Especializado** (+77% mejora de precisión) analiza el contenido clínico.
  </Step>

  <Step title="Resultados estructurados">
    Reciba **códigos ICD-10** con puntuaciones de confianza, **justificaciones** detalladas y códigos descartados con razonamiento — listo para flujos de facturación y codificación.
  </Step>
</Steps>

**Ventaja clave:** Transparencia completa con puntuaciones de confianza y justificaciones ayuda a los codificadores a tomar decisiones informadas y mantener estándares de calidad.

***

## Endpoints disponibles

<Columns cols={2}>
  <Card title="POST /v1/codify">
    Codifica texto clínico en una estructura JSON que usted define.
  </Card>

  <Card title="GET /v1/health">
    Verifica que el servicio está operativo.
  </Card>
</Columns>

***

## Playground Interactivo de la API

La documentación incluye un **playground interactivo de la API** basado en la especificación OpenAPI. Puede probar llamadas a la API directamente desde el navegador sin escribir código.

<Steps>
  <Step title="Navegar a la Referencia de API">
    Vaya a la sección **Referencia de API** en la pestaña SofIA API, o haga clic [aquí](/api-reference/codify-clinical-text-into-a-json-structure-you-define).
  </Step>

  <Step title="Configurar autenticación">
    Introduzca su token Bearer en el campo **Authorization** en la parte superior del playground.
  </Step>

  <Step title="Completar la petición">
    Use los campos del formulario para construir su petición, o cambie a la pestaña **Body** para pegar JSON directamente. El playground valida su entrada contra el esquema OpenAPI en tiempo real.
  </Step>

  <Step title="Enviar e inspeccionar">
    Haga clic en **Send** para ejecutar la petición. El panel de respuesta muestra el código de estado, headers y el cuerpo JSON formateado.
  </Step>
</Steps>

<Tip>
  El playground usa sus credenciales reales de API. Use datos de prueba (no información real de pacientes) al experimentar.
</Tip>

***

## Versionado de la API

### Esquema de versiones

* **Versionado por ruta:** `/v1/`, `/v2/`, etc.
* **Cambios compatibles:** Se añaden a la versión actual sin romper la API
* **Cambios incompatibles:** Incrementan la versión mayor (ej: v1 → v2)

> **Versión actual**: **v1.0.0** — Lanzamiento inicial del endpoint público

***

## Siguientes pasos

<Columns cols={2}>
  <Card title="1. Inicio Rápido" icon="book" href="/sofia/es/api/quickstart">
    Su primera llamada a la API
  </Card>

  <Card title="2. Autenticación" icon="lock" href="/sofia/es/api/auth">
    Configuración de *tokens* y *headers*
  </Card>

  <Card title="3. Estructura de datos" icon="paste" href="/sofia/es/api/request-response">
    Peticiones y respuestas
  </Card>

  <Card title="4. Ver ejemplos" icon="lightbulb" href="/sofia/es/api/examples">
    Ejemplos prácticos de codificación
  </Card>

  <Card title="5. Operación y errores" icon="gear" href="/sofia/es/api/operations">
    Manejo de errores y seguridad
  </Card>

  <Card title="6. Referencia completa" icon="book" href="/api-reference/codify-clinical-text-into-a-json-structure-you-define">
    Especificación OpenAPI
  </Card>
</Columns>