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