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 যেসব অবজেক্ট তৈরি করে তার দৃষ্টান্তমূলক উদাহরণ, সিন্থেটিক ডেটাসহ — প্রকৃত গ্রাহক বা রেকর্ড নয়। ফিল্ডের নামগুলি Threada-র API এবং অডিট স্কিমা অনুসরণ করে।
- উদাহরণ WorkItem (JSON) generation_mode: illustrative_sample · provenance_citation: docs/spec/product.md#design-principles
- উদাহরণ এভিডেন্স বান্ডিল (JSON) generation_mode: illustrative_sample · provenance_citation: docs/spec/product.md#design-principles
- উদাহরণ অ্যাকশন রসিদ (JSON) generation_mode: illustrative_sample · provenance_citation: docs/spec/product.md#design-principles
- উদাহরণ অডিট এক্সপোর্ট (CSV) generation_mode: illustrative_sample · provenance_citation: docs/spec/product.md#design-principles
ইমপ্লিমেন্টেশন নির্দেশনা প্রয়োজন?
রোলআউট এবং গভর্ন্যান্স প্যাটার্নের জন্য ডক্স এবং টেকনিক্যাল ওভারভিউ ব্যবহার করুন।
টেকনিক্যাল টিমের সাথে যোগাযোগ করুন