Deployments

Por qué deployments?

Los deployments te dan una capa de indirección que hace tu integración más robusta:

Actualiza sin cambiar código. Publica una nueva versión de la structure y asígnala al deployment. Tus llamadas API no cambian.

Separa entornos. Usa deployments diferentes para desarrollo, staging y producción — cada uno apuntando a la versión correcta.

Historial de cambios. Cada vez que cambias la versión de structure que usa un deployment, queda registrado.

Qué contiene un deployment?

Componente	Descripción
Deployment ID	Un UUID único que usas en las llamadas API.
Structure	La structure (y versión) que este deployment usa para procesar.
Nombre	Una etiqueta legible para tu referencia.

Los deployments se crean y gestiónan en el Dashboard de Matil. La API se usa únicamente para procesar documentos a través de ellos.

Usar un deployment

Una vez tienes un deployment ID, procesar un documento es una sola llamada:

curl -X POST "https://api.matil.ai/v3/deployments/{deployment_id}" \
  -H "x-api-key: tu-api-key" \
  -H "Content-Type: application/json" \
  -d '{"documents": [{"type": "url", "url": "https://ejemplo.com/factura.pdf"}]}'

El deployment determina que structure y versión aplicar. También tienes variantes asíncrona y por lotes:

Modo	Endpoint	Descripción
Síncrono	`POST /v3/deployments/{id}`	Bloquea hasta que el procesamiento termina. Devuelve el resultado directamente.
Asíncrono	`POST /v3/deployments/{id}/async`	Devuelve inmediatamente. El resultado se entrega vía webhook.
Por lotes	`POST /v3/deployments/{id}/batch`	Envía hasta 100 elementos. Resultados entregados vía webhook.

Primeros pasos

Conceptos

Por qué deployments?

Qué contiene un deployment?

Usar un deployment

Siguientes pasos

Structures

Modos de procesamiento

​Por qué deployments?

​Qué contiene un deployment?

​Usar un deployment

​Siguientes pasos

Structures

Modos de procesamiento

Por qué deployments?

Qué contiene un deployment?

Usar un deployment

Siguientes pasos