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

API குறிப்பு

WorkItem செயல்பாடுகள், முடிவு-படிக் கட்டுப்பாடுகள், ஒருங்கிணைப்புச் செயலாக்கம் மற்றும் டெலிமெட்ரி ஏற்றுமதிக்கான குறிப்பு.

தெளிவான கொள்கை மற்றும் tenant வரம்பிடலுடன் கணிக்கக்கூடிய தன்னியக்க நடத்தைக்காக இந்த APIகள் வடிவமைக்கப்பட்டுள்ளன.

அடிப்படை endpoint

அங்கீகரிக்கப்பட்ட கோரிக்கைகளுக்கு உங்கள் கட்டமைக்கப்பட்ட பொது API endpoint-ஐப் பயன்படுத்துங்கள்.

https://api.threada.ai

அங்கீகாரம் மற்றும் சூழல்

  • API அணுகலுக்கு வரம்பிடப்பட்ட சான்றுகளைப் பயன்படுத்துங்கள்
  • தேவைப்படும் இடத்தில் tenant மற்றும் பங்கு சூழலைச் சேர்க்கவும்
  • சரியான சூழல் இல்லாத கோரிக்கைகள் மூடப்பட்டு தோல்வியடைகின்றன

வழக்கமான வரம்புகள்

  • workitems:read மற்றும் workitems:write
  • கொள்கை மற்றும் முடிவு புதுப்பிப்புகளுக்கு workflow:manage
  • நிர்வகிக்கப்பட்ட செயலாக்கத்திற்கு actions:execute
  • ஏற்றுமதிகள் மற்றும் பகுப்பாய்வுக்கு telemetry:read

பக்கப்பிரிப்பு மற்றும் வடிகட்டல்

  • பட்டியல் endpointகள் cursor- அல்லது token-அடிப்படையிலான பக்கப்பிரிப்பை ஆதரிக்கின்றன
  • சேனல், பணிப்பாய்வு, நிலை, கொள்கைப் பதிப்பு மற்றும் கால வரம்பின் அடிப்படையில் வடிகட்டுங்கள்
  • பெரிய டெலிமெட்ரி ஏற்றுமதிகளுக்கு வரம்புக்குட்பட்ட சாளரங்களை விரும்புங்கள்

பிழை மாதிரி

  • சரிபார்ப்பு, அங்கீகாரம், கொள்கை மற்றும் செயலாக்கத் தோல்விகளுக்கான வகைப்படுத்தப்பட்ட பிழை வகைகள்
  • ஆபரேட்டர் கருவிகளில் உறுதியான கையாளுதலை reason குறியீடுகள் ஆதரிக்கின்றன
  • சேவைகளுக்கிடையிலான விசாரணைக்காக Correlation IDகள் வழங்கப்படுகின்றன

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

Intake payload-இலிருந்து ஒரு WorkItem-ஐ உருவாக்குங்கள்

பணிப்பாய்வு செயலாக்கத்திற்கான ஒரு நியதி வேலைப் பதிவை உருவாக்குங்கள். தேவைப்படும்போது intake சேனலுக்கான சேனல் identifier-ஐச் சேர்க்கவும்.

கோரிக்கை 
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\"]}"
Response 
{
  "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}\"}}"
Response 
{
  "action": {
    "action_id": "act_456",
    "work_item_id": "wi_123",
    "action_type": "custom_http",
    "status": "completed"
  }
}

மாதிரிக் கலைப்பொருட்கள்

Threada உருவாக்கும் objects-இன் விளக்கமான எடுத்துக்காட்டுகள், செயற்கைத் தரவுடன் — உண்மையான வாடிக்கையாளர்கள் அல்லது பதிவுகள் அல்ல. புல பெயர்கள் Threada-இன் API மற்றும் தணிக்கை schemas-ஐப் பின்பற்றுகின்றன.

செயல்படுத்தலுக்கு வழிகாட்டுதல் தேவையா?

அறிமுகம் மற்றும் ஆளுகை வடிவங்களுக்கு ஆவணங்களையும் தொழில்நுட்பக் கண்ணோட்டத்தையும் பயன்படுத்துங்கள்.

தொழில்நுட்பக் குழுவைத் தொடர்புகொள்ளவும்