Tsallaka zuwa abun ciki

Manazartar API

Manazarta don WorkItem ayyuka, matakin yanke shawara sarrafa, haɗaɗɗen tsari aiwatarwa, da telemetry fitarwa.

Waɗannan APIs suna designed don predictable sarrafa ta atomatik behavior da explicit manufa da ƙungiya scoping.

Endpoint na tushe

Use naka wani saita public API endpoint don authenticated buƙatu.

https://api.threada.ai

Authentication da mahalli

  • Use scoped takardun shaida don API samun dama
  • Include ƙungiya da matsayi mahalli inda ana buƙata
  • Buƙatu ba tare da valid mahalli fail closed

Typical iyakokin izini

  • Workitems:karanta da workitems:write
  • Workflow:manage don sabunta manufa da yanke shawara
  • Matakai:aiwatar don mai kulawa aiwatarwa
  • Telemetry:karanta don fitarwa da analysis

Pagination da taceing

  • List endpoints tallafi cursor- ko token-based pagination
  • Tace ta tasha, workflow, matsayi, sigar manufa, da zangon lokaci
  • Prefer bounded windows don large telemetry fitarwa

Kuskure model

  • Typed kuskure categories don tantancewa, authorization, manufa, da aiwatarwa failures
  • Lambobin dalili tallafi deterministic handling in mai gudanarwa tooling
  • Correlation IDs suna returned don cross-sabis investigation

Misali buƙatu

Ƙirƙiri WorkItem daga payload na shigarwa

Ƙirƙiri canonical work record don sarrafa workflow. Haɗa ma’anar tasha don tashar shigarwa idan ana buƙata.

Buƙata 
curl -X POST "https://api.threada.ai/work-items" \ -H "Authorization: Bearer <token>" \ -H "Abun ciki-Type: application/json" \ -d "{\"workflow_id\":\"policy_review\",\"channel_id\":\"web_main\",\"payload\":{\"message\":\"Review this renewal request before approval\"}}"
Amsa 
{
  "work_item_id": "wi_123",
  "status": "new",
  "workflow_id": "policy_review"
}

Aiwatar an an amince mataki

Gudanar wani manufa-approved mataki da wani wani saita haɗaɗɗen tsari.

Buƙata 
curl -X POST "https://api.threada.ai/actions/execute" \ -H "Authorization: Bearer <token>" \ -H "Abun ciki-Type: application/json" \ -d "{\"work_item_id\":\"wi_123\",\"action_id\":\"request_approval\",\"integration_id\":\"int_workflow\"}"
Amsa 
{
  "execution_id": "ex_456",
  "status": "started",
  "idempotency_key": "idem_789"
}

Buƙata implementation guidance?

Use wannan takardu da fasaha overview don rollout da kulawa patterns.

Contact fasaha ƙungiya