API referansı

WorkItem işlemleri, karar adımı kontrolleri, entegrasyon yürütme ve telemetri dışa 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ırdığınız 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ı ve rol bağlamını ekleyin
Geçerli bağlamı olmayan istekler güvenli kapanır

Tipik kapsamlar

workitems:read ve workitems:write
Politika ve karar güncellemeleri için workflow:manage
Yönetişimli yürütme için actions:execute
Dışa aktarımlar 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 türlenmiş hata kategorileri
Neden kodları, operatör araçlarında deterministik işlemeyi 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 kanonik bir iş kaydı oluşturun. Gerektiğinde giriş kanalı için kanal tanımlayıcısını ekleyin.

İstek

curl -X POST "https://api.threada.ai/api/v1/public/work-items" \
  -H "X-API-Key: <api-key>" \
  -H "Content-Type: application/json" \
  -d "{\"subject\":\"Review renewal request\",\"channel\":\"web\",\"channel_id\":\"web_main\",\"initial_message\":{\"role\":\"user\",\"content\":\"Review this renewal request before approval\"},\"tags\":[\"policy_review\"]}"

Yanıt

{
  "work_item": {
    "summary": {
      "work_item_id": "wi_123",
      "status": "new",
      "subject": "Review renewal request"
    }
  }
}

Onaylanmış bir eylemi yürütün

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

İstek

curl -X POST "https://api.threada.ai/api/v1/public/work-items/wi_123/actions" \
  -H "X-API-Key: <api-key>" \
  -H "Content-Type: application/json" \
  -d "{\"integration_id\":\"int_workflow\",\"idempotency_key\":\"act_456\",\"payload\":{\"type\":\"custom_http\",\"method\":\"POST\",\"url\":\"https://api.example.com/approvals\",\"body_json\":\"{\\\"approved\\\":true}\"}}"

Yanıt

{
  "action": {
    "action_id": "act_456",
    "work_item_id": "wi_123",
    "action_type": "custom_http",
    "status": "completed"
  }
}

Örnek yapay nesneler

Threada'nın ürettiği nesnelerin sentetik verilerle hazırlanmış açıklayıcı örnekleri — gerçek müşteriler veya kayıtlar değil. Alan adları Threada'nın API ve denetim şemalarını izler.

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

Yayına alma ve yönetişim modelleri için dokümanları ve teknik genel bakışı kullanın.

Teknik ekiple iletişime geçin