Rejea ya API

Reference kwa WorkItem uendeshaji, uamuzi-step vidhibiti, integration utekelezaji, na telemetry safirisha.

These APIs ni designed kwa predictable otomatiki behavior kwa explicit sera na tenant scoping.

Endpoint ya msingi

Use yako imesanidiwa public API endpoint kwa authenticated maombi.

https://api.threada.ai

Authentication na muktadha

Use wenye upeo vitambulisho kwa API ufikiaji
Include tenant na jukumu muktadha wapi inahitajika
Maombi bila halali muktadha fail closed

Typical mawanda

workitems:read na workitems:write
mtiririko wa kazi:manage kwa sera na uamuzi updates
vitendo:tekeleza kwa utekelezaji unaosimamiwa
telemetry:read kwa usafirishaji na analysis

Pagination na filtering

List endpoints usaidizi cursor- au token-based pagination
Kichujio by kituo, mtiririko wa kazi, hali, sera toleo, na time range
Prefer bounded windows kwa large telemetry usafirishaji

Hitilafu model

Typed hitilafu categories kwa validation, authorization, sera, na utekelezaji failures
Reason codes usaidizi isiyobahatisha handling katika operatori tooling
Correlation IDs ni returned kwa cross-service investigation

Example maombi

Unda WorkItem kutoka upokeaji payload

Unda canonical kazi rekodi kwa mtiririko wa kazi processing. Include hii kituo identifier kwa hii upokeaji kituo wakati inahitajika.

Ombi

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

Response

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

Tekeleza imeidhinishwa kitendo

Run sera-imeidhinishwa kitendo against imesanidiwa integration.

Ombi

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

Response

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

Unahitaji mwongozo wa utekelezaji?

Use hii docs na kiufundi muhtasari kwa rollout na utawala patterns.

Contact kiufundi team