solvethree API त्रुटियाँ: क्या ठीक करें और कब दोबारा कोशिश करें

सफलता का पेलोड पढ़ने से पहले असफल HTTP प्रतिक्रियाओं को संभालें। POST /v1/tasks के लिए, 201 का मतलब है कि नया टास्क बनाया गया; 200 का मतलब है कि आइडेम्पोटेंट रीप्ले ने मौजूदा टास्क लौटाया। किसी भी प्रतिक्रिया का मतलब यह नहीं है कि समाधान प्रयास पूरा हो गया है।

400 — अमान्य अनुरोध बॉडी

सबमिट की गई बॉडी की तुलना अपने टास्क प्रकार के दस्तावेज़ में दिए गए फ़ील्ड और आवश्यकताओं से करें।

यह आज़माएँ: दोबारा सबमिट करने से पहले इनपुट ठीक करें। उसी अमान्य बॉडी के साथ दोबारा प्रयास करने से समस्या ठीक नहीं होगी। अनुरोध जाँचने के लिए टास्क बनाने का कॉन्ट्रैक्ट इस्तेमाल करें।

401 — अमान्य API कुंजी

जाँचें कि अनुरोध में Authorization: Bearer के बाद वर्कस्पेस की मान्य API कुंजी दी गई है।

यह आज़माएँ: गायब कुंजी जोड़ें या अस्वीकृत कुंजी ठीक करें। उसे ब्राउज़र कोड में उजागर करने के बजाय सर्वर पर रखें।

402 — अपर्याप्त क्रेडिट

API कुंजी से जुड़े वर्कस्पेस का क्रेडिट बैलेंस जाँचें।

यह आज़माएँ: दोबारा प्रयास करने से पहले उस वर्कस्पेस में क्रेडिट जोड़ें। असंबंधित HTTP त्रुटियों या टास्क की विफलताओं को बैलेंस की समस्या न मानें।

403 — निष्क्रिय साइट प्रोफ़ाइल

reCAPTCHA के लिए, पुष्टि करें कि लक्ष्य साइट की सक्रिय प्रोफ़ाइल आपके वर्कस्पेस के लिए उपलब्ध है।

यह आज़माएँ: कंसोल में लक्ष्य साइट सेट अप करें और पुष्टि करें कि प्रोफ़ाइल सक्रिय है। टास्क में होस्टनेम और ऐक्शन देने से प्रोफ़ाइल नहीं बनती। यह गेटवे प्रतिक्रिया इस बात का प्रमाण नहीं है कि लक्ष्य वेबसाइट ने आपको ब्लॉक किया है।

409 — अनुरोध ID का टकराव

जाँचें कि क्या वही requestId पहले अलग टास्क इनपुट के साथ इस्तेमाल हुआ था।

यह आज़माएँ: मूल टास्क रिकवर करने के लिए मूल इनपुट इस्तेमाल करें। अगर आप अलग टास्क बनाना चाहते हैं, तो उसे नई अनुरोध ID दें।

410 — सहेजे गए परिणाम की अवधि समाप्त

जाँचें कि क्या आप ऐसा पूरा हो चुका टास्क प्राप्त कर रहे हैं जिसका सहेजा गया परिणाम अब रखा नहीं गया है।

यह आज़माएँ: उस परिणाम को प्राप्त करना बंद करें। अगर आपको अब भी समाधान चाहिए, तो नया समाधान प्रयास शुरू करें। यह स्थिति API के परिणाम रिटेंशन को दर्शाती है, लक्ष्य टोकन या कुकी की वैधता अवधि को नहीं।

429 — अनुरोध दर सीमित

वास्तविक Retry-After प्रतिक्रिया पढ़ें।

यह आज़माएँ: दोबारा प्रयास करने से पहले निर्देश के अनुसार प्रतीक्षा करें और अनुरोध दर कम करें। दर सीमित होने पर उसी दर से पोलिंग या सबमिट करना जारी न रखें।

502 — जनरेशन सेवा अनुपलब्ध

सेवा की अनुपलब्धता को अमान्य इनपुट या अपर्याप्त क्रेडिट से अलग समझें।

यह आज़माएँ: बाद में दोबारा प्रयास करें। उसी टास्क बनाने के अनुरोध का फिर प्रयास करने के लिए उसकी अनुरोध ID और बिना बदलाव वाले टास्क इनपुट दोबारा इस्तेमाल करें।

HTTP 503 का मतलब है कि जनरेशन क्षमता उपलब्ध नहीं है। बाद में दोबारा प्रयास करें; उसी टास्क बनाने के अनुरोध के लिए उसकी अनुरोध ID और बिना बदलाव वाले टास्क इनपुट दोबारा इस्तेमाल करें।

• pending या solving: मौजूदा टास्क की पोलिंग जारी रखें; सिर्फ़ उसके तैयार न होने के कारण उसकी जगह नया टास्क न बनाएँ।
• ready: पोलिंग रोकें और समाधान पढ़ें।
• failed: पोलिंग रोकें और errorCode व error देखें।

{
  "id": "example_login_001",
  "status": "failed",
  "errorCode": "site-unreachable",
  "error": "target page did not respond"
}

यहाँ site-unreachable टास्क का त्रुटि कोड है, HTTP स्थिति नहीं। दूसरे समाधान का अनुरोध करने से पहले सबमिट किया गया लक्ष्य URL जाँचें और देखें कि पेज प्रतिक्रिया देता है या नहीं। अधिक पोलिंग से यह विफल टास्क दोबारा शुरू नहीं होगा, और इसकी मूल अनुरोध ID से अनुरोध दोबारा भेजने पर नया टास्क शुरू होने के बजाय मौजूदा टास्क लौटता है।

कनेक्शन टाइमआउट से यह साबित नहीं होता कि टास्क बनाना विफल हुआ। टास्क बनाने के पहले प्रयास से पहले वैकल्पिक requestId इस्तेमाल करें, ताकि आप उसी लॉजिकल टास्क को सुरक्षित रूप से रिकवर कर सकें। इसमें 1–64 ASCII अक्षर, अंक, अंडरस्कोर या हाइफ़न होने चाहिए।

1. 1.

   अगर आपके पास टास्क ID है, तो टास्क प्राप्त करें

   GET /v1/tasks/:id इस्तेमाल करें और टास्क की स्थिति जाँचने से पहले HTTP प्रतिक्रिया संभालें।

2. 2.

   अगर टास्क बनाने की प्रतिक्रिया खो गई है, तो मूल अनुरोध दोबारा भेजें

   उन्हीं टास्क इनपुट को उसी अनुरोध ID के साथ सबमिट करें। अगर टास्क बन चुका है, तो आइडेम्पोटेंट रीप्ले मौजूदा टास्क लौटाता है। उस ID के तहत इनपुट न बदलें।

3. 3.

   उसकी जगह नया टास्क तभी बनाएँ जब आप दूसरा समाधान प्रयास शुरू करना चाहते हों

   नई अनुरोध ID नए काम को दर्शाती है, पिछले अनुरोध की रिकवरी को नहीं। इसे सोच-समझकर इस्तेमाल करें—जैसे अंतिम विफलता की जाँच करने और दोबारा प्रयास करने का निर्णय लेने के बाद।

रीप्ले संभालने के लिए अनुरोध ID से रिकवरी देखें, या अगर टास्क बन गया है लेकिन अब भी चल रहा है, तो पोलिंग और टाइमआउट देखें।