உள்ளடக்கத்திற்குச் செல்லவும்

API குறிப்பு

Reference க்கான WorkItem செயல்பாடுகள், முடிவு படி கட்டுப்பாடுகள், integration செயலாக்கம், மற்றும் telemetry export.

இந்த APIs உள்ளன designed க்கான predictable தன்னியக்கம் behavior உடன் தெளிவான கொள்கை மற்றும் tenant scoping.

அடிப்படை endpoint

Use உங்கள் கட்டமைக்கப்பட்டது public API endpoint க்கான authenticated கோரிக்கைகள்.

https://api.threada.ai

Authentication மற்றும் context

  • Use scoped credentials க்கான API அணுகல்
  • Include tenant மற்றும் பங்கு context எங்கு தேவையான
  • கோரிக்கைகள் இல்லாமல் சரியான context fail closed

வழக்கமான scopes

  • WorkItems:படி மற்றும் WorkItems:எழுது
  • workflow:நிர்வகி க்கான கொள்கை மற்றும் முடிவு updates
  • செயல்கள்:செயல்படுத்து க்கான நிர்வகிக்கப்பட்ட செயலாக்கம்
  • telemetry:படி க்கான exports மற்றும் analysis

Pagination மற்றும் filtering

  • பட்டியல் endpoints support cursor- அல்லது token-based pagination
  • வடிகட்டு மூலம் சேனல், workflow, நிலை, கொள்கை version, மற்றும் time range
  • Prefer வரையறுக்கப்பட்ட windows க்கான large telemetry exports

பிழை model

  • Typed பிழை categories க்கான validation, authorization, கொள்கை, மற்றும் செயலாக்கம் failures
  • Reason codes support deterministic handling இல் ஆபரேட்டர் tooling
  • Correlation IDs உள்ளன returned க்கான cross-சேவை investigation

எடுத்துக்காட்டு கோரிக்கைகள்

ஒரு WorkItem இலிருந்து intake payload உருவாக்கு

ஒரு canonical வேலை பதிவு க்கான workflow processing. Include சேனல் identifier க்கான intake சேனல் போது தேவையான. உருவாக்கு

கோரிக்கை 
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\"}}"
Response 
{
  "work_item_id": "wi_123",
  "status": "new",
  "workflow_id": "policy_review"
}

செயல்படுத்து ஒரு ஒப்புதல் அளிக்கப்பட்டது செயல்

இயக்கு ஒரு கொள்கை-ஒப்புதல் அளிக்கப்பட்டது செயல் against ஒரு கட்டமைக்கப்பட்டது integration.

கோரிக்கை 
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\"}"
Response 
{
  "execution_id": "ex_456",
  "status": "started",
  "idempotency_key": "idem_789"
}

தேவை implementation guidance?

Use docs மற்றும் technical கண்ணோட்டம் க்கான rollout மற்றும் ஆளுமை patterns.

technical அணி தொடர்புகொள்ளவும்