ST Structa Engine
ES EN

Onboarding

Structa Engine ahora expone una superficie pública pensada para venta, activación técnica y operación. La entrada recomendada es:

  1. Registrar un tenant desde /app/register.
  2. Copiar la API key productiva y la sandbox.
  3. Entrar al workspace del tenant con la API key.
  4. Usar el panel admin con X-Admin-Key para operar la plataforma.

Autenticación

  • Tenants: Authorization: Bearer sk_structa_...
  • Sandbox: usa la key sandbox generada en signup.
  • Admin: X-Admin-Key

El contrato actual del backend mantiene POST /v1/signup con campo password. El nuevo frontend lo comunica de forma explícita: hoy el acceso operativo sigue siendo por API keys.

Ingesta y jobs

Los flujos principales quedan cubiertos en el workspace:

  • POST /v1/ingest
  • POST /v1/ingest/bulk
  • GET /v1/jobs/{job_id}
  • GET /v1/jobs/{job_id}/events
  • GET /v1/jobs/{job_id}/runs
  • GET /v1/runs/{run_id}
  • POST /v1/jobs/{job_id}/reprocess
  • POST /v1/jobs/{job_id}/migrate
  • DELETE /v1/jobs/{job_id}
curl -X POST http://localhost:18000/v1/ingest \
  -H "Authorization: Bearer sk_structa_..." \
  -F 'text=Compra de prueba'

Review y calidad

La interfaz tenant incluye reglas y cola de review:

  • GET /v1/review/rules
  • PUT /v1/review/rules
  • GET /v1/review/tasks
  • POST /v1/review/tasks/{task_id}/claim
  • POST /v1/review/tasks/{task_id}/approve
  • POST /v1/review/tasks/{task_id}/reject
  • POST /v1/review/tasks/{task_id}/correct

Uso, webhooks y exportaciones

  • GET /v1/metrics/summary
  • GET /v1/metrics/stages
  • GET /v1/metrics/usage
  • GET /v1/usage/daily
  • GET /v1/usage/monthly
  • GET /v1/admin/webhooks
  • POST /v1/admin/webhooks
  • GET /v1/webhooks/deliveries
  • POST /v1/jobs/{job_id}/export

Admin y operación

La consola administrativa concentra:

  • tenants, API keys y planes
  • quotas por tenant
  • providers LLM/OCR
  • modelos y policy de routing
  • queues, workers y circuits
  • DLQ y webhooks deliveries
  • explorer autenticado para endpoints avanzados

Explorer integrado

El frontend incluye un explorer autenticado para cubrir endpoints menos frecuentes. Esto complementa la UI dedicada y evita dejar la operación atada únicamente a Swagger.

Swagger y OpenAPI

  • Swagger backend: http://localhost:18000/docs
  • OpenAPI: http://localhost:18000/openapi.json
  • Frontend público: http://localhost:4321