दस्तावेज़AI Scraperत्वरित शुरुआतकार्य जीवनचक्र

टास्क लाइफसाइकिल विवरण

अपनी रिक्वेस्ट्स को तैयार करने और टास्क की पूरी अवधि के दौरान AI Scraper API द्वारा लौटाए गए हर रिस्पॉन्स को समझने के लिए निम्नलिखित संदर्भ का उपयोग करें।

सामान्य रिक्वेस्ट पैरामीटर

पैरामीटरTypeRequiredविवरण
actorstringहाँएक स्थिर पहचानकर्ता जो यह दर्शाता है कि आप कौन सा मॉडल चलाना चाहते हैं।
webhookobjectनहींवैकल्पिक वेबहुक सेटिंग्स वाला ऑब्जेक्ट।
webhook.urlstringनहींHTTPS एंडपॉइंट जो टास्क पूरा होने पर परिणाम प्राप्त करता है।
inputobjectहाँप्रॉम्प्ट, मोड या देश जैसे एक्टर-विशिष्ट पैरामीटर।

रिजल्ट डेटा संरचना

पैरामीटरTypeRequiredविवरण
statusstringहाँटास्क स्थिति: pending, running, success, या failed।
messagestringनहींयदि टास्क विफल हो जाता है तो त्रुटि संदेश।
task_resultobjectनहींएक्टर के लिए पूर्ण पेलोड। फ़ील्ड-स्तरीय विवरणों के लिए एक्टर दस्तावेज़ देखें।

वेबहुक पुश पेलोड

यदि आप webhook.url सेट करते हैं, तो Scrapeless निम्नलिखित JSON संरचना के साथ एक POST रिक्वेस्ट भेजता है:

पैरामीटरTypeRequiredविवरण
task_idstringहाँपूर्ण टास्क का पहचानकर्ता।
statusstringहाँsuccess या failed।
inputstringहाँJSON के रूप में क्रमबद्ध (serialized) मूल टास्क पैरामीटर।
task_resultobjectनहींवही संरचना जो आपको रिजल्ट एंडपॉइंट को पोल करते समय प्राप्त होगी।

पुश उदाहरण

curl --location '{webhook.url}' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "",
    "status": "",
    "input": "",
    "task_result": {}
  }'

HTTP स्टेटस कोड

StatusMeaning
200सफलता। परिणाम प्राप्त कर लिया गया है।
201टास्क सफलतापूर्वक बनाया गया।
202टास्क अभी भी चल रहा है—जल्द ही पुनः प्रयास करें।
400अमान्य रिक्वेस्ट या निष्पादन विफल। विवरण के लिए त्रुटि संदेश जांचें।
410टास्क परिणाम की समय सीमा समाप्त हो गई है।
429दर सीमा (rate limit) पार हो गई है। रिक्वेस्ट आवृत्ति कम करें या क्षमता बढ़ाएं।