सामग्रीकडे जा

API संदर्भ

WorkItem संचालन, निर्णय-चरण नियंत्रणे, इंटिग्रेशन अंमलबजावणी आणि टेलीमेट्री निर्यातासाठी संदर्भ.

हे API स्पष्ट धोरण आणि टेनंट स्कोपिंगसह पूर्वानुमेय ऑटोमेशन वर्तनासाठी रचलेले आहेत.

आधार एंडपॉइंट

प्रमाणित विनंत्यांसाठी तुमचा कॉन्फिगर केलेला सार्वजनिक API एंडपॉइंट वापरा.

https://api.threada.ai

प्रमाणीकरण आणि संदर्भ

  • API प्रवेशासाठी स्कोप केलेली क्रेडेन्शियल वापरा
  • जिथे आवश्यक असेल तिथे टेनंट आणि भूमिका संदर्भ समाविष्ट करा
  • वैध संदर्भाशिवाय विनंत्या बंद-स्थितीत अयशस्वी होतात

विशिष्ट स्कोप

  • workitems:read आणि workitems:write
  • धोरण व निर्णय अद्यतनांसाठी workflow:manage
  • शासित अंमलबजावणीसाठी actions:execute
  • निर्यात व विश्लेषणासाठी telemetry:read

पेजिनेशन आणि फिल्टरिंग

  • सूची एंडपॉइंट कर्सर- किंवा टोकन-आधारित पेजिनेशनला समर्थन देतात
  • चॅनल, वर्कफ्लो, स्थिती, धोरण आवृत्ती आणि कालमर्यादेनुसार फिल्टर करा
  • मोठ्या टेलीमेट्री निर्यातांसाठी मर्यादित विंडोला प्राधान्य द्या

त्रुटी मॉडेल

  • सत्यापन, प्राधिकरण, धोरण आणि अंमलबजावणी अपयशांसाठी टाइप केलेल्या त्रुटी श्रेणी
  • कारण कोड ऑपरेटर टूलिंगमध्ये निश्चित हाताळणीला समर्थन देतात
  • क्रॉस-सर्व्हिस तपासासाठी सहसंबंध आयडी परत केले जातात

उदाहरण विनंत्या

इनटेक पेलोडमधून एक 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 तयार करत असलेल्या ऑब्जेक्ट्सची उदाहरणादाखल उदाहरणे, कृत्रिम (synthetic) डेटासह — खरे ग्राहक किंवा नोंदी नव्हेत. फील्ड नावे Threada च्या API आणि ऑडिट स्कीमांचे अनुसरण करतात.

अंमलबजावणी मार्गदर्शनाची आवश्यकता आहे?

रोलआउट आणि गव्हर्नन्स पॅटर्नसाठी दस्तऐवज व तांत्रिक आढावा वापरा.

तांत्रिक टीमशी संपर्क साधा