কনটেন্টে যান

API রেফারেন্স

WorkItem অপারেশন, ডিসিশন-স্টেপ কন্ট্রোল, ইন্টিগ্রেশন এক্সিকিউশন, এবং টেলিমেট্রি এক্সপোর্টের রেফারেন্স।

এই APIগুলি স্পষ্ট নীতি এবং ভাড়াটে স্কোপিং সহ অনুমানযোগ্য অটোমেশন আচরণের জন্য ডিজাইন করা হয়েছে।

বেস এন্ডপয়েন্ট

প্রমাণীকৃত অনুরোধের জন্য আপনার কনফিগার করা সর্বজনীন API এন্ডপয়েন্ট ব্যবহার করুন।

https://api.threada.ai

প্রমাণীকরণ এবং প্রসঙ্গ

  • API অ্যাক্সেসের জন্য স্কোপড শংসাপত্র ব্যবহার করুন
  • যেখানে প্রয়োজন সেখানে ভাড়াটে এবং ভূমিকার প্রসঙ্গ অন্তর্ভুক্ত করুন
  • বৈধ প্রসঙ্গ ছাড়া অনুরোধ বন্ধ বন্ধ

সাধারণ স্কোপ

  • workitems:read এবং workitems:write
  • নীতি এবং সিদ্ধান্ত আপডেটের জন্য workflow:manage
  • actions:execute শাসিত সম্পাদনের জন্য
  • রপ্তানি এবং বিশ্লেষণের জন্য telemetry:read

পেজিনেশন এবং ফিল্টারিং

  • তালিকার শেষ পয়েন্টগুলি কার্সার- বা টোকেন-ভিত্তিক পৃষ্ঠা সংখ্যাকে সমর্থন করে
  • চ্যানেল, কর্মপ্রবাহ, স্থিতি, নীতি সংস্করণ, এবং সময় পরিসীমা দ্বারা ফিল্টার করুন
  • বড় টেলিমেট্রি রপ্তানির জন্য আবদ্ধ উইন্ডো পছন্দ করুন

ত্রুটি মডেল

  • বৈধতা, অনুমোদন, নীতি, এবং কার্যকরী ব্যর্থতার জন্য টাইপ করা ত্রুটি বিভাগ
  • কারণ কোডগুলি অপারেটর টুলিং-এ নির্ধারক হ্যান্ডলিং সমর্থন করে
  • ক্রস-সার্ভিস তদন্তের জন্য পারস্পরিক সম্পর্ক আইডি ফেরত দেওয়া হয়

উদাহরণ অনুরোধ

ইনটেক পেলোড থেকে একটি ওয়ার্কআইটেম তৈরি করুন

ওয়ার্কফ্লো প্রক্রিয়াকরণের জন্য একটি আদর্শ কাজের রেকর্ড তৈরি করুন। প্রয়োজনে ইনটেক চ্যানেলের জন্য চ্যানেল শনাক্তকারী অন্তর্ভুক্ত করুন।

অনুরোধ
curl -X POST "https://api.threada.ai/work-items" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{\"workflow_id\":\"policy_review\",\"channel_id\":\"web_main\",\"payload\":{\"message\":\"Review this renewal request before approval\"}}"
প্রতিক্রিয়া
{
  "work_item_id": "wi_123",
  "status": "new",
  "workflow_id": "policy_review"
}

একটি অনুমোদিত ক্রিয়া সম্পাদন করুন

কনফিগার করা ইন্টিগ্রেশনের বিরুদ্ধে নীতি-অনুমোদিত অ্যাকশন চালান।

অনুরোধ
curl -X POST "https://api.threada.ai/actions/execute" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d "{\"work_item_id\":\"wi_123\",\"action_id\":\"request_approval\",\"integration_id\":\"int_workflow\"}"
প্রতিক্রিয়া
{
  "execution_id": "ex_456",
  "status": "started",
  "idempotency_key": "idem_789"
}

বাস্তবায়ন নির্দেশিকা প্রয়োজন?

রোলআউট এবং গভর্নেন্স প্যাটার্নের জন্য ডক্স এবং প্রযুক্তিগত ওভারভিউ ব্যবহার করুন।

প্রযুক্তিগত দলের সাথে যোগাযোগ করুন