API एरर कोड संदर्भ#

मूल URL: https://api.ideal.house
संस्करण: v1
अपडेटेड: 2026-03-06

📖 अवलोकन#

सभी API प्रतिक्रियाएँ एक एकीकृत JSON संरचना का पालन करती हैं। जब कोई त्रुटि होती है, तो code फ़ील्ड में एक शून्य-अन्य एरर कोड होगा, और message फ़ील्ड त्रुटि का मानव-पठनीय वर्णन प्रदान करेगी।

एकीकृत प्रतिक्रिया प्रारूप

{
  "code": 1001,
  "message": "Request failed",
  "data": null
}

✅ सफलता कोड#

उदाहरण

{
  "code": 0,
  "message": "success",
  "data": { }
}

❌ एरर कोड#

🔧 सामान्य त्रुटियाँ#

🔐 प्रमाणीकरण त्रुटियाँ#

🛡️ कंटेंट मॉडरेशन त्रुटियाँ#

💰 क्रेडिट त्रुटियाँ#

📋 पूर्ण एरर कोड सारांश#

📦 एरर प्रतिक्रिया उदाहरण#

1001 — अनुरोध विफल#

{
  "code": 1001,
  "message": "Request failed",
  "data": null
}

1003 — आंतरिक सर्वर त्रुटि#

{
  "code": 1003,
  "message": "Internal server error",
  "data": null
}

1011 — पैरामीटर त्रुटि#

{
  "code": 1011,
  "message": "Request parameter error: imageUrl is required",
  "data": null
}

5002 — अमान्य API की#

{
  "code": 5002,
  "message": "Invalid API Key",
  "data": null
}

9010 — टेक्स्ट कंटेंट मॉडरेशन विफल#

{
  "code": 9010,
  "message": "Text prompt failed content review, contains prohibited content",
  "data": null
}

9038 — आउटपुट प्रतिबंधित सामग्री#

{
  "code": 9038,
  "message": "Prohibited content",
  "data": null
}

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

{
  "code": 9051,
  "message": "Insufficient coins",
  "data": null
}

💡 त्रुटि प्रबंधन के लिए सर्वोत्तम प्रथाएँ#

1. हमेशा code की जाँच करें — केवल HTTP स्थिति कोडों पर निर्भर न रहें; प्रतिक्रिया शरीर में code फ़ील्ड की हमेशा जाँच करें।
2. 1001 को गतिशील रूप से संभालें — यह एक सामान्य एरर कोड है; message फ़ील्ड में विशिष्ट कारण होगा।
3. 1003 पर पुनः प्रयास करें — सर्वर-साइड त्रुटियाँ आमतौर पर अस्थायी होती हैं; हर नए प्रयास से पहले प्रतीक्षा का समय घातीय रूप से बढ़ाने वाला तर्क लागू करें।
4. भेजने से पहले इनपुट को सत्यापित करें — 1011 त्रुटियों से बचने के लिए API कॉल करने से पहले क्लाइंट-साइड पर आवश्यक फ़ील्ड को सत्यापित करें।
5. कंटेंट मॉडरेशन — यदि आपको 9010 या 9038 प्राप्त होता है, तो पुनः सबमिट करने से पहले अपनी सामग्री का मूल्यांकन प्लेटफ़ॉर्म के कंटेंट नीति के विरुद्ध करें।

© Ideal House AI — सर्वाधिकार सुरक्षित।