కంటెంట్‌కు వెళ్లండి

API సూచన

WorkItem కార్యకలాపాలు, నిర్ణయ-దశ నియంత్రణలు, ఇంటిగ్రేషన్ అమలు మరియు టెలిమెట్రీ ఎగుమతికి సూచిక.

స్పష్టమైన పాలసీ మరియు టెనెంట్ పరిధితో అంచనా వేయగల ఆటోమేషన్ ప్రవర్తన కోసం ఈ API-లను రూపొందించారు.

మూల ఎండ్‌పాయింట్

ప్రామాణీకరించిన అభ్యర్థనలకు మీ కాన్ఫిగర్ చేసిన పబ్లిక్ API ఎండ్‌పాయింట్‌ను ఉపయోగించండి.

https://api.threada.ai

ప్రామాణీకరణ మరియు సందర్భం

  • API యాక్సెస్ కోసం పరిధి కలిగిన క్రెడెన్షియల్‌లను ఉపయోగించండి
  • అవసరమైన చోట టెనెంట్ మరియు పాత్ర సందర్భాన్ని చేర్చండి
  • చెల్లుబాటు అయ్యే సందర్భం లేని అభ్యర్థనలు ఫెయిల్-క్లోజ్డ్ అవుతాయి

సాధారణ స్కోప్‌లు

  • workitems:read మరియు workitems:write
  • పాలసీ మరియు నిర్ణయ నవీకరణలకు workflow:manage
  • పాలిత అమలు కోసం actions:execute
  • ఎగుమతులు మరియు విశ్లేషణకు telemetry:read

పేజినేషన్ మరియు ఫిల్టరింగ్

  • జాబితా ఎండ్‌పాయింట్లు కర్సర్ లేదా టోకెన్ ఆధారిత పేజినేషన్‌ను సపోర్ట్ చేస్తాయి
  • ఛానల్, వర్క్‌ఫ్లో, స్థితి, పాలసీ వెర్షన్ మరియు సమయ పరిధి వారీగా ఫిల్టర్ చేయండి
  • పెద్ద టెలిమెట్రీ ఎగుమతులకు పరిమిత విండోలను వాడండి

లోపం మోడల్

  • ధ్రువీకరణ, అధికారం, పాలసీ మరియు అమలు వైఫల్యాలకు టైప్ చేసిన ఎర్రర్ వర్గాలు
  • ఆపరేటర్ సాధనాల్లో నిర్ణీత నిర్వహణకు కారణ కోడ్‌లు తోడ్పడతాయి
  • సర్వీసుల మధ్య పరిశోధనకు కోరిలేషన్ ID-లు తిరిగి వస్తాయి

ఉదాహరణ అభ్యర్థనలు

ఇన్‌టేక్ పేలోడ్ నుండి WorkItem సృష్టించండి

వర్క్‌ఫ్లో ప్రాసెసింగ్ కోసం ప్రామాణిక పని రికార్డును సృష్టించండి. అవసరమైనప్పుడు ఇన్‌టేక్ ఛానల్ యొక్క ఛానల్ గుర్తింపును చేర్చండి.

అభ్యర్థన
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\"]}"
ప్రతిస్పందన
{
  "work_item": {
    "summary": {
      "work_item_id": "wi_123",
      "status": "new",
      "subject": "Review renewal request"
    }
  }
}

ఆమోదించిన చర్యను అమలు చేయండి

కాన్ఫిగర్ చేసిన ఇంటిగ్రేషన్‌పై పాలసీ-ఆమోదిత చర్యను నడపండి.

అభ్యర్థన
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}\"}}"
ప్రతిస్పందన
{
  "action": {
    "action_id": "act_456",
    "work_item_id": "wi_123",
    "action_type": "custom_http",
    "status": "completed"
  }
}

నమూనా ఆర్టిఫాక్ట్‌లు

Threada ఉత్పత్తి చేసే ఆబ్జెక్ట్‌లకు సింథటిక్ డేటాతో కూడిన ఉదాహరణాత్మక నమూనాలు — నిజమైన కస్టమర్లు లేదా రికార్డులు కాదు. ఫీల్డ్ పేర్లు Threada యొక్క API మరియు ఆడిట్ స్కీమాలను అనుసరిస్తాయి.

అమలు మార్గదర్శనం కావాలా?

రోల్‌అవుట్ మరియు గవర్నెన్స్ నమూనాలకు డాక్యుమెంట్లు మరియు సాంకేతిక అవలోకనాన్ని వాడండి.

సాంకేతిక బృందాన్ని సంప్రదించండి