Aller au contenu

Référence API

Référence pour les opérations WorkItem, les contrôles d'étape de décision, l'exécution de l'intégration et l'exportation de télémétrie.

Ces API sont conçus pour un comportement d’automatisation prévisible avec une stratégie explicite et une portée des locataires.

Point de terminaison de base

Utilisez votre point de terminaison public API configuré pour les demandes authentifiées.

https://api.threada.ai

Authentification et contexte

  • Utiliser des informations d'identification limitées pour l'accès à l'API
  • Inclure le contexte du locataire et du rôle si nécessaire
  • Les requêtes sans contexte valide échouent et sont fermées

Portées typiques

  • workitems:read et workitems:write
  • workflow:manage pour les mises à jour des politiques et des décisions
  • actions:execute pour une exécution gouvernée
  • telemetry:read pour les exportations et l'analyse

Pagination et filtrage

  • Les points de terminaison de liste prennent en charge la pagination basée sur un curseur ou un jeton
  • Filtrer par canal, flux de travail, statut, version de politique et plage horaire
  • Préférez les fenêtres délimitées pour les grandes exportations de télémétrie

Modèle d'erreur

  • Catégories d'erreurs typées pour les échecs de validation, d'autorisation, de stratégie et d'exécution
  • Les codes de raison prennent en charge la gestion déterministe dans les outils de l'opérateur
  • Les ID de corrélation sont renvoyés pour une enquête interservices

Exemples de demandes

Créer un WorkItem à partir de la charge utile d'admission

Créez un enregistrement de travail canonique pour le traitement du flux de travail. Incluez l’identifiant du canal d’admission si nécessaire.

Demande 
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\"}}"
Réponse 
{
  "work_item_id": "wi_123",
  "status": "new",
  "workflow_id": "policy_review"
}

Exécuter une action approuvée

Exécutez une action approuvée par la stratégie sur une intégration configurée.

Demande 
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\"}"
Réponse 
{
  "execution_id": "ex_456",
  "status": "started",
  "idempotency_key": "idem_789"
}

Besoin de conseils de mise en œuvre ?

Utilisez la documentation et la présentation technique pour connaître les modèles de déploiement et de gouvernance.

Contacter l'équipe technique