Vai al contenuto

Riferimento API

Riferimento per operazioni WorkItem, controlli decision-step, esecuzione integrazioni ed export telemetria.

Queste API sono progettate per un comportamento di automazione prevedibile con policy esplicite e scoping tenant.

Endpoint base

Usa l'endpoint API pubblico configurato per richieste autenticate.

https://api.threada.ai

Autenticazione e contesto

  • Usa credenziali scoped per accesso API
  • Includi contesto tenant e ruolo dove richiesto
  • Le richieste senza contesto valido falliscono in modo chiuso

Scope tipici

  • workitems:read e workitems:write
  • workflow:manage per policy e aggiornamenti decisionali
  • actions:execute per esecuzione governata
  • telemetry:read per export e analisi

Paginazione e filtro

  • Gli endpoint list supportano paginazione basata su cursore o token
  • Filtra per canale, workflow, stato, versione policy e intervallo temporale
  • Preferisci finestre limitate per grandi export di telemetria

Modello errori

  • Categorie di errore tipizzate per fallimenti di validazione, autorizzazione, policy ed esecuzione
  • I reason code supportano gestione deterministica negli strumenti operatore
  • I correlation ID vengono restituiti per indagine cross-service

Richieste di esempio

Crea un WorkItem da payload di intake

Crea un record di lavoro canonico per l'elaborazione workflow. Includi l'identificatore canale per il canale di intake quando richiesto.

Richiesta 
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\"}}"
Risposta 
{
  "work_item_id": "wi_123",
  "status": "new",
  "workflow_id": "policy_review"
}

Esegui un'azione approvata

Esegui un'azione approvata da policy su un'integrazione configurata.

Richiesta 
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\"}"
Risposta 
{
  "execution_id": "ex_456",
  "status": "started",
  "idempotency_key": "idem_789"
}

Ti serve guida per l'implementazione?

Usa documenti e panoramica tecnica per pattern di rollout e governance.

Contatta il team tecnico