Saltar al contenido principal
Un deployment conecta una structure a un ID estable que usas en las llamadas a la API. En lugar de pasar configuración en cada petición, apuntas a un deployment y Matil sabe exactamente qué hacer.

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

ComponenteDescripción
Deployment IDUn UUID único que usas en las llamadas API.
StructureLa structure (y versión) que este deployment usa para procesar.
NombreUna 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:
ModoEndpointDescripción
SíncronoPOST /v3/deployments/{id}Bloquea hasta que el procesamiento termina. Devuelve el resultado directamente.
AsíncronoPOST /v3/deployments/{id}/asyncDevuelve inmediatamente. El resultado se entrega vía webhook.
Por lotesPOST /v3/deployments/{id}/batchEnvía hasta 100 elementos. Resultados entregados vía webhook.

​
Siguientes pasos

Structures

Aprende cómo definir los datos que quieres extraer.

Modos de procesamiento

Detalles del procesamiento síncrono, asíncrono y por lotes.