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