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