Ruka hadi kwenye maudhui

Rejea ya API

Rejea kwa uendeshaji wa WorkItem, vidhibiti vya hatua za uamuzi, utekelezaji wa muunganisho, na usafirishaji wa telemetria.

API hizi zimeundwa kwa tabia ya otomatiki inayotabirika ikiwa na upeo dhahiri wa sera na mpangaji.

Lango la msingi

Tumia lango lako lililosanidiwa la API ya umma kwa maombi yaliyothibitishwa.

https://api.threada.ai

Uthibitishaji na muktadha

  • Tumia vitambulisho vyenye upeo kwa ufikiaji wa API
  • Jumuisha muktadha wa mpangaji na jukumu pale inapohitajika
  • Maombi yasiyo na muktadha halali hushindwa kwa usalama

Mawanda ya kawaida

  • workitems:read na workitems:write
  • workflow:manage kwa masasisho ya sera na uamuzi
  • actions:execute kwa utekelezaji unaosimamiwa
  • telemetry:read kwa usafirishaji na uchanganuzi

Ugawanyaji kurasa na uchujaji

  • Malango ya orodha yanaunga mkono ugawanyaji kurasa unaotegemea kielekezi au tokeni
  • Chuja kwa kituo, mtiririko wa kazi, hali, toleo la sera, na masafa ya muda
  • Pendelea madirisha yenye mipaka kwa usafirishaji mkubwa wa telemetria

Modeli ya hitilafu

  • Aina za hitilafu zilizoainishwa kwa kushindwa kwa uthibitishaji, uidhinishaji, sera, na utekelezaji
  • Misimbo ya sababu huwezesha ushughulikiaji wa kuamua katika zana za waendeshaji
  • Vitambulisho vya uhusiano hurejeshwa kwa uchunguzi wa huduma mbalimbali

Mifano ya maombi

Unda WorkItem kutoka kwa mzigo wa upokeaji

Unda rekodi kuu ya kazi kwa uchakataji wa mtiririko wa kazi. Jumuisha kitambulisho cha kituo kwa kituo cha upokeaji pale inapohitajika.

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

Tekeleza kitendo kilichoidhinishwa

Endesha kitendo kilichoidhinishwa na sera dhidi ya muunganisho uliosanidiwa.

Ombi 
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}\"}}"
Response 
{
  "action": {
    "action_id": "act_456",
    "work_item_id": "wi_123",
    "action_type": "custom_http",
    "status": "completed"
  }
}

Vipande vya mfano

Mifano ya kielelezo ya vitu ambavyo Threada huzalisha, vikiwa na data ya kubuni — si wateja halisi wala rekodi halisi. Majina ya sehemu yanafuata skimu za API na ukaguzi za Threada.

Unahitaji mwongozo wa utekelezaji?

Tumia nyaraka na muhtasari wa kiufundi kwa mifumo ya uzinduzi na utawala.

Wasiliana na timu ya kiufundi