Bỏ qua đến nội dung

Tham chiếu API

Tham chiếu cho thao tác WorkItem, kiểm soát bước quyết định, thực thi tích hợp và xuất telemetry.

Các API này được thiết kế cho hành vi tự động hóa dự đoán được với chính sách và phạm vi tenant rõ ràng.

Endpoint cơ sở

Use của bạn đã cấu hình công khai API endpoint cho đã xác thực yêu cầu.

https://api.threada.ai

xác thực và ngữ cảnh

  • Use thông tin xác thực có phạm vi cho API truy cập
  • bao gồm tenant và vai trò ngữ cảnh khi bắt buộc
  • yêu cầu mà không valid ngữ cảnh fail closed

điển hình phạm vi

  • workitems:read và workitems:write
  • workflow:manage cho chính sách và quyết định updates
  • actions:execute cho được quản trị thực thi
  • telemetry:read cho bản xuất và analysis

Pagination và filtering

  • danh sách endpoints hỗ trợ cursor- hoặc token-based pagination
  • bộ lọc bởi kênh, quy trình, trạng thái, phiên bản chính sách, và thời gian range
  • Prefer có giới hạn khung thời gian cho large telemetry bản xuất

lỗi mô hình

  • Typed lỗi danh mục cho xác thực, ủy quyền, chính sách, và thực thi failures
  • mã lý do hỗ trợ xác định handling trong công cụ cho operator
  • ID tương quan là returned cho cross-service investigation

Example yêu cầu

tạo một WorkItem từ intake payload

tạo một canonical công việc bản ghi cho quy trình xử lý. bao gồm kênh định danh cho intake kênh khi bắt buộc.

yêu cầu 
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\"}}"
phản hồi 
{
  "work_item_id": "wi_123",
  "status": "new",
  "workflow_id": "policy_review"
}

thực thi một đã phê duyệt hành động

chạy một policy-approved hành động đối với một đã cấu hình tích hợp.

yêu cầu 
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\"}"
phản hồi 
{
  "execution_id": "ex_456",
  "status": "started",
  "idempotency_key": "idem_789"
}

Need implementation hướng dẫn?

Use docs và technical tổng quan cho triển khai và quản trị patterns.

Liên hệ đội kỹ thuật