टास्क लाइफसायकल विवरण
निम्न संदर्भ आपको अनुरोध तैयार करने और API से मिलने वाली हर प्रतिक्रिया को समझने में मदद करता है।
सामान्य अनुरोध पैरामीटर
| पैरामीटर | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
actor | string | हाँ | इंगित करता है कि कौन-सा मॉडल चलाना है। |
webhook | object | नहीं | वैकल्पिक webhook कॉन्फ़िगरेशन। |
webhook.url | string | नहीं | HTTPS endpoint जहाँ टास्क पूरा होने पर परिणाम भेजा जाएगा। |
input | object | हाँ | actor-विशिष्ट पैरामीटर (prompt, mode, country आदि)। |
परिणाम डेटा संरचना
| फ़ील्ड | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
status | string | हाँ | टास्क स्थिति: pending, running, success, failed. |
message | string | नहीं | असफल होने पर त्रुटि संदेश। |
task_result | object | नहीं | actor का पूर्ण परिणाम; विवरण के लिए संबंधित मॉडल पेज देखें। |
Webhook payload
यदि webhook.url दिया है तो Scrapeless नीचे दिए JSON के साथ POST अनुरोध भेजेगा:
| फ़ील्ड | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
task_id | string | हाँ | पूर्ण टास्क का आईडी। |
status | string | हाँ | success या failed. |
input | string | हाँ | मूल अनुरोध पैरामीटर का JSON स्ट्रिंग। |
task_result | object | नहीं | वही संरचना जो result endpoint पर मिलती है। |
Push उदाहरण
curl --location '{webhook.url}' \
--header 'Content-Type: application/json' \
--data '{
"task_id": "",
"status": "",
"input": "",
"task_result": {}
}'HTTP स्टेटस कोड
| कोड | अर्थ |
|---|---|
200 | परिणाम सफलतापूर्वक प्राप्त हुआ। |
201 | टास्क सफलतापूर्वक बना। |
202 | टास्क अभी भी चल रहा है; बाद में पुनः कोशिश करें। |
400 | अवैध अनुरोध; त्रुटि संदेश देखें। |
410 | परिणाम की वैधता समाप्त (डिफ़ॉल्ट 12 घंटे)। |
429 | अनुरोध सीमा पार हो गई। |