Tsallaka zuwa abun ciki

Manazartar API

Manazarta don ayyukan WorkItem, sarrafa matakin yanke shawara, aiwatar da haɗaɗɗun tsarin, da fitar da telemetry.

An tsara waɗannan APIs don halayyar sarrafa kai mai hango sauƙi tare da iyakance manufa da ƙungiya bayyanannu.

Endpoint na tushe

Yi amfani da endpoint na public API ɗinka da aka saita don buƙatu da aka tantance.

https://api.threada.ai

Tantancewa da mahalli

  • Yi amfani da takardun shaida masu iyaka don samun dama ga API
  • Haɗa mahallin ƙungiya da matsayi inda ake buƙata
  • Buƙatun da ba su da mahalli mai inganci suna gazawa cikin kulawa

Iyakokin izini na yau da kullum

  • workitems:read da workitems:write
  • workflow:manage don sabunta manufa da yanke shawara
  • actions:execute don aiwatarwa mai kulawa
  • telemetry:read don fitarwa da nazari

Shafe-shafe da tacewa

  • Endpoints na lissafi suna tallafin shafe-shafe bisa cursor ko token
  • Tace ta tasha, workflow, matsayi, sigar manufa, da zangon lokaci
  • Ka fifita tagogi masu iyaka don fitar da telemetry mai yawa

Tsarin kuskure

  • Ƙungiyoyin kuskure masu nau'i don tantancewa, izini, manufa, da gazawar aiwatarwa
  • Lambobin dalili suna tallafin tafiyarwa tabbatacciya a kayan aikin masu gudanarwa
  • Ana mayar da Correlation IDs don bincike a tsakanin sabis

Misalan buƙatu

Ƙirƙiri WorkItem daga payload na shigarwa

Ƙirƙiri rikodin aiki na asali don sarrafa workflow. Haɗa ma'anar tasha don tashar shigarwa idan ana buƙata.

Buƙata 
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\"]}"
Amsa 
{
  "work_item": {
    "summary": {
      "work_item_id": "wi_123",
      "status": "new",
      "subject": "Review renewal request"
    }
  }
}

Aiwatar da matakin da aka amince

Gudanar da matakin da manufa ta amince da haɗaɗɗen tsarin da aka saita.

Buƙata 
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}\"}}"
Amsa 
{
  "action": {
    "action_id": "act_456",
    "work_item_id": "wi_123",
    "action_type": "custom_http",
    "status": "completed"
  }
}

Samfuran kayan da aka samar

Misalan kwatanci na abubuwan da Threada take samarwa, tare da bayanan roba — ba abokan ciniki ko rikodi na ainihi ba. Sunayen filaye suna bin schemas na API da na bincike na Threada.

Kana buƙatar jagora kan aiwatarwa?

Yi amfani da takardu da bayanin fasaha don tsarin fitarwa da sarrafawa.

Tuntuɓi ƙungiyar fasaha