API referansı

WorkItem işlemleri, karar adımı kontrolleri, entegrasyon yürütme ve telemetri aktarımı için referans.

Bu API'lar, açık politika ve kiracı kapsamı belirlemeyle öngörülebilir otomasyon davranışı için tasarlanmıştır.

Temel uç nokta

Kimliği doğrulanmış istekler için yapılandırılmış genel API uç noktanızı kullanın.

https://api.threada.ai

Kimlik doğrulama ve bağlam

API erişimi için kapsamlı kimlik bilgilerini kullanın
Gerektiğinde kiracıyı ve rol bağlamını ekleyin
Geçerli bağlamı olmayan istekler başarısız olarak kapatılıyor

Tipik kapsamlar

workitems:read ve workitems:write
Politika ve karar güncellemeleri için workflow:manage
Yönetilen yürütme için actions:execute
Dışa aktarım ve analiz için telemetry:read

Sayfalandırma ve filtreleme

Liste uç noktaları imleç veya belirteç tabanlı sayfalandırmayı destekler
Kanala, iş akışına, duruma, politika sürümüne ve zaman aralığına göre filtreleyin
Büyük telemetri dışa aktarımları için sınırlı pencereleri tercih edin

Hata modeli

Doğrulama, yetkilendirme, politika ve yürütme hataları için yazılan hata kategorileri
Neden kodları, operatör takımlarında deterministik kullanımı destekler
Hizmetler arası inceleme için korelasyon kimlikleri döndürülür

Örnek istekler

Alım yükünden bir WorkItem oluşturun

İş akışı işleme için standart bir iş kaydı oluşturun. Gerektiğinde giriş kanalı için kanal tanımlayıcısını ekleyin.

Rica etmek

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\"}}"

Cevap

{
  "work_item_id": "wi_123",
  "status": "new",
  "workflow_id": "policy_review"
}

Onaylanmış bir eylemi yürütme

Yapılandırılmış bir entegrasyona karşı politika onaylı bir eylem çalıştırın.

Rica etmek

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\"}"

Cevap

{
  "execution_id": "ex_456",
  "status": "started",
  "idempotency_key": "idem_789"
}

Uygulama rehberliğine mi ihtiyacınız var?

Kullanıma sunma ve yönetişim modelleri için dokümanları ve teknik genel bakışı kullanın.

Teknik ekiple iletişime geçin