Saltar al contenido

Referencia de API

Referencia para operaciones WorkItem, controles de pasos de decisión, ejecución de integración y exportación de telemetría.

Estas API están diseñadas para un comportamiento de automatización predecible con políticas explícitas y alcance de inquilinos.

Punto final base

Utilice su punto final público API configurado para solicitudes autenticadas.

https://api.threada.ai

Autenticación y contexto

  • Utilice credenciales con ámbito para acceder a la API
  • Incluir contexto de inquilino y rol cuando sea necesario
  • Las solicitudes sin contexto válido fallan al cerrarse

Alcances típicos

  • workitems:read y workitems:write
  • workflow:manage para actualizaciones de políticas y decisiones
  • actions:execute para ejecución gobernada
  • telemetry:read para exportaciones y análisis

Paginación y filtrado.

  • Los puntos finales de lista admiten paginación basada en cursor o token
  • Filtrar por canal, flujo de trabajo, estado, versión de política y rango de tiempo
  • Prefiere ventanas delimitadas para grandes exportaciones de telemetría

Modelo de error

  • Categorías de errores escritos para fallas de validación, autorización, políticas y ejecución
  • Los códigos de motivo respaldan el manejo determinista en las herramientas del operador
  • Los ID de correlación se devuelven para la investigación entre servicios

Solicitudes de ejemplo

Crear un WorkItem a partir de la carga útil de entrada

Cree un registro de trabajo canónico para el procesamiento del flujo de trabajo. Incluya el identificador del canal de entrada cuando sea necesario.

Pedido 
curl -X POST "https://api.threada.ai/work-items" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{\"workflow_id\":\"policy_review\",\"channel_id\":\"web_main\",\"payload\":{\"message\":\"Review this renewal request before approval\"}}"
Respuesta 
{
  "work_item_id": "wi_123",
  "status": "new",
  "workflow_id": "policy_review"
}

Ejecutar una acción aprobada

Ejecute una acción aprobada por políticas contra una integración configurada.

Pedido 
curl -X POST "https://api.threada.ai/actions/execute" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{\"work_item_id\":\"wi_123\",\"action_id\":\"request_approval\",\"integration_id\":\"int_workflow\"}"
Respuesta 
{
  "execution_id": "ex_456",
  "status": "started",
  "idempotency_key": "idem_789"
}

¿Necesita orientación para la implementación?

Utilice los documentos y la descripción técnica para conocer los patrones de implementación y gobernanza.

Contactar equipo técnico