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

# Cómo funciona Vía API

> Las 3 formas de procesar documentos cuando creas verificaciones vía API directa en Trébol.

Cuando creas verificaciones **vía API**, tienes máximo control sobre cómo se procesa cada documento. Existen **3 formas** de procesamiento, y tú decides cuál usar según tu caso de uso.

## Las 3 formas

| Forma                           | Item a usar                                    | Qué hace Trébol                                                                |
| ------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------ |
| **1. Clasificación automática** | `generic`                                      | Detecta el tipo del documento y extrae la información correspondiente          |
| **2. Validación**               | `doc_validation`                               | Valida que el documento sea del tipo esperado y cumpla las reglas configuradas |
| **3. Extracción**               | tipo directo (ej: `ac_mx`, `csf_mx`, `rut_co`) | Extrae directamente la información del tipo especificado, sin validar          |

## Cuál elegir

<CardGroup cols={3}>
  <Card title="Forma 1: Clasificación" href="/docs/guia-devs/crear-verificaciones/via-api/forma-clasificacion">
    **Usa si:** no sabes el tipo del documento o prefieres que Trébol lo detecte y clasifique por ti.
  </Card>

  <Card title="Forma 2: Validación" href="/docs/guia-devs/crear-verificaciones/via-api/forma-validacion">
    **Usa si:** sabes qué tipo de documento esperas y quieres verificar que el archivo cumple antes de procesarlo.
  </Card>

  <Card title="Forma 3: Extracción" href="/docs/guia-devs/crear-verificaciones/via-api/forma-extraccion">
    **Usa si:** ya sabes el tipo del documento (o confías en que es correcto) y solo necesitas la información extraída.
  </Card>
</CardGroup>

## Combinar Validación + Extracción

Si quieres **primero validar y después extraer solo si la validación fue exitosa**, es lógica que tú construyes combinando Forma 2 y Forma 3:

1. Crea un item `doc_validation` (Forma 2) para validar
2. Espera el resultado (vía webhook o consulta periódica)
3. Si la validación pasó, agrega un item con tipo directo (Forma 3) para extraer

Ver más detalle en [Forma 3: Extracción](/docs/guia-devs/crear-verificaciones/via-api/forma-extraccion#combinar-con-validacion).

## Siguiente paso

Independiente de la forma que elijas, todos los flujos usan el mismo endpoint base `POST /verifications`. Consulta [Crear una verificación](/docs/guia-devs/crear-verificaciones/via-api/crear-verificacion) para entender el endpoint y sus atributos.