Retool

Guarda la clave como variable de configuración secretaCopy Anchor Link

En Settings → Configuration variables crea CONSTAIA_API_KEY, márcala como secret y dale el valor ck_test_… (y el valor live en el entorno de producción, si usas entornos). Las variables secretas solo se pueden usar en la configuración de recursos, no en el código de las apps.

Crea el recurso REST APICopy Anchor Link

En Resources → Create new → REST API:

Todas las consultas que usen este recurso llevarán la cabecera sin que la clave aparezca en la app.

ComponentesCopy Anchor Link

Crea una app y añade:

• fileInput1: un File Input que acepte imágenes y PDF.
• typeSelect: un Select para el tipo esperado.
• analyzeButton: un Button con el texto "Analizar".
• fieldsTable: una Table para los campos extraídos.
• reasonsTable: una Table para los motivos del veredicto.

Carga el catálogo de tiposCopy Anchor Link

Crea la consulta documentTypes sobre el recurso Constaia: método GET, ruta document-types?language=es, ejecución automática. En typeSelect usa como datos {{ documentTypes.data.data }}, como valor {{ item.type }} y como etiqueta {{ item.label }}. El endpoint devuelve el catálogo completo, con los campos de cada tipo.

Crea la consulta de análisisCopy Anchor Link

Crea la consulta analyzeDocument sobre el recurso Constaia:

Con este cuerpo:

{{ JSON.stringify({
  file_base64: fileInput1.value[0].base64Data,
  filename: fileInput1.value[0].name,
  options: {
    expect: typeSelect.value,
    language: "es",
    metadata: { reviewer: current_user.email }
  }
}) }}

fileInput1.value es la lista de ficheros seleccionados; cada uno trae el contenido en base64 y el nombre. Comprueba los nombres exactos de las propiedades en el inspector de estado del componente, porque pueden variar entre versiones de Retool. En analyzeButton, añade un manejador de evento Click que ejecute analyzeDocument.

Si trabajas con claves live, activa en la consulta la confirmación antes de ejecutarla: cada análisis consume créditos.

Muestra el resultadoCopy Anchor Link

• Un Text con el veredicto: {{ analyzeDocument.data?.verdict?.status ?? analyzeDocument.data?.status }}.
• reasonsTable con {{ analyzeDocument.data?.verdict?.reasons ?? [] }} (columnas code, severity, message).
• fieldsTable con:

{{ Object.entries(analyzeDocument.data?.fields ?? {}).map(([name, f]) => ({
  campo: name,
  valor: typeof f.value === "object" ? JSON.stringify(f.value) : f.value,
  confianza: f.confidence,
  validado: f.validated,
})) }}

Más en Veredictos. Si la consulta falla, Retool la marca como fallida y el cuerpo del error de Constaia (error.code, error.message, error.request_id) aparece en el resultado de la consulta; añade un manejador Failure que muestre una notificación. Los códigos están en Errores.