API సూచన
WorkItem కార్యకలాపాలు, నిర్ణయ-దశ నియంత్రణలు, ఇంటిగ్రేషన్ అమలు మరియు టెలిమెట్రీ ఎగుమతికి సూచిక.
స్పష్టమైన పాలసీ మరియు టెనెంట్ పరిధితో అంచనా వేయగల ఆటోమేషన్ ప్రవర్తన కోసం ఈ API-లను రూపొందించారు.
మూల ఎండ్పాయింట్
ప్రామాణీకరించిన అభ్యర్థనలకు మీ కాన్ఫిగర్ చేసిన పబ్లిక్ API ఎండ్పాయింట్ను ఉపయోగించండి.
https://api.threada.ai ప్రామాణీకరణ మరియు సందర్భం
- API యాక్సెస్ కోసం పరిధి కలిగిన క్రెడెన్షియల్లను ఉపయోగించండి
- అవసరమైన చోట టెనెంట్ మరియు పాత్ర సందర్భాన్ని చేర్చండి
- చెల్లుబాటు అయ్యే సందర్భం లేని అభ్యర్థనలు ఫెయిల్-క్లోజ్డ్ అవుతాయి
సాధారణ స్కోప్లు
- workitems:read మరియు workitems:write
- పాలసీ మరియు నిర్ణయ నవీకరణలకు workflow:manage
- పాలిత అమలు కోసం actions:execute
- ఎగుమతులు మరియు విశ్లేషణకు telemetry:read
పేజినేషన్ మరియు ఫిల్టరింగ్
- జాబితా ఎండ్పాయింట్లు కర్సర్ లేదా టోకెన్ ఆధారిత పేజినేషన్ను సపోర్ట్ చేస్తాయి
- ఛానల్, వర్క్ఫ్లో, స్థితి, పాలసీ వెర్షన్ మరియు సమయ పరిధి వారీగా ఫిల్టర్ చేయండి
- పెద్ద టెలిమెట్రీ ఎగుమతులకు పరిమిత విండోలను వాడండి
లోపం మోడల్
- ధ్రువీకరణ, అధికారం, పాలసీ మరియు అమలు వైఫల్యాలకు టైప్ చేసిన ఎర్రర్ వర్గాలు
- ఆపరేటర్ సాధనాల్లో నిర్ణీత నిర్వహణకు కారణ కోడ్లు తోడ్పడతాయి
- సర్వీసుల మధ్య పరిశోధనకు కోరిలేషన్ ID-లు తిరిగి వస్తాయి
ఉదాహరణ అభ్యర్థనలు
ఇన్టేక్ పేలోడ్ నుండి 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
అమలు మార్గదర్శనం కావాలా?
రోల్అవుట్ మరియు గవర్నెన్స్ నమూనాలకు డాక్యుమెంట్లు మరియు సాంకేతిక అవలోకనాన్ని వాడండి.
సాంకేతిక బృందాన్ని సంప్రదించండి