त्रुटि कोड और स्थिति संदर्भ

Smart Money API त्रुटि कोड, HTTP स्थिति कोड और समस्या निवारण चरणों की व्यापक मार्गदर्शिका। त्रुटि प्रतिक्रियाओं को समझें और एकीकरण समस्याओं को तेजी से हल करें।

2xx सफलता कोड

सफलता प्रतिक्रियाएँ इंगित करती हैं कि अनुरोध सफलतापूर्वक संसाधित किया गया था।

कोड	स्थिति	अर्थ
200	OK	अनुरोध सफल हुआ। प्रतिक्रिया बॉडी में अनुरोधित डेटा शामिल है।
201	Created	संसाधन सफलतापूर्वक बनाया गया। प्रतिक्रिया में नया संसाधन शामिल है।
204	No Content	अनुरोध सफल हुआ लेकिन लौटाने के लिए कोई सामग्री नहीं है (जैसे, DELETE)।

उदाहरण 200 प्रतिक्रिया

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [...],
    "pagination": {
      "page": 1,
      "limit": 50
    }
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

4xx क्लाइंट त्रुटि कोड

क्लाइंट त्रुटियाँ इंगित करती हैं कि अनुरोध गलत या अमान्य था। अपने अनुरोध को ठीक करें और पुनः प्रयास करें।

कोड	स्थिति	कारण
400	Bad Request	गलत अनुरोध सिंटैक्स। क्वेरी पैरामीटर, हेडर और अनुरोध बॉडी की जाँच करें।
401	Unauthorized	गुम या अमान्य प्रमाणीकरण क्रेडेंशियल्स। अपने API कुंजी या JWT टोकन की जाँच करें।
402	Payment Required	आपका सब्सक्रिप्शन भुगतान विफल रहा। अपने खाते में बिलिंग जानकारी अपडेट करें।
403	Forbidden	प्रमाणीकृत लेकिन इस संसाधन के लिए अधिकृत नहीं। आपकी योजना में यह सुविधा शामिल नहीं है।
404	Not Found	संसाधन मौजूद नहीं है। एंडपॉइंट URL और पैरामीटर की जाँच करें।
429	Too Many Requests	दर सीमा पार हो गई। पुनः प्रयास करने से पहले प्रतीक्षा करें। Retry-After हेडर की जाँच करें।
422	Unprocessable Entity	सत्यापन विफल। अनुरोध पैरामीटर अमान्य हैं या आवश्यक फ़ील्ड गुम हैं।

प्रमाणीकरण त्रुटि उदाहरण

गुम API कुंजी (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "प्रमाणीकरण क्रेडेंशियल्स प्रदान नहीं किए गए।",
    "resolution": "Authorization हेडर में अपनी API कुंजी शामिल करें: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

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

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "अमान्य या समाप्त API कुंजी।",
    "resolution": "https://smartmoneyapi.com/console पर अपने कंसोल से एक नई API कुंजी जनरेट करें"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

दर सीमित (429)

जब आप अपनी API कोटा पार करते हैं, तो सर्वर 429 Too Many Requests लौटाता है। दर सीमा जानकारी के लिए प्रतिक्रिया हेडर की जाँच करें:

HTTP हेडर

X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600

दर सीमा त्रुटि प्रतिक्रिया

JSON

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "दैनिक API अनुरोध सीमा (10) पार हो गई।",
    "resolution": "Trader ($29/माह, 1,000 अनुरोध/दिन) या Pro ($79/माह, 5,000 अनुरोध/दिन) योजना में अपग्रेड करें।",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

सत्यापन त्रुटियाँ (422)

सत्यापन त्रुटियाँ तब होती हैं जब आपके अनुरोध पैरामीटर अमान्य होते हैं या आवश्यक फ़ील्ड गुम होते हैं।

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "अनुरोध सत्यापन विफल।",
    "details": [
      {
        "field": "symbol",
        "error": "अमान्य ट्रेडिंग पेयर। अपेक्षित प्रारूप: BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "एक धनात्मक संख्या होनी चाहिए"
      }
    ],
    "resolution": "सत्यापन त्रुटियों को ठीक करें और पुनः प्रयास करें।"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

5xx सर्वर त्रुटि कोड

सर्वर त्रुटियाँ हमारी तरफ से एक समस्या का संकेत देती हैं। ये अस्थायी होती हैं और आमतौर पर जल्दी हल हो जाती हैं। एक्सपोनेंशियल बैकऑफ़ पुनः प्रयास तर्क लागू करें।

कोड	स्थिति	कार्रवाई
500	Internal Error	अप्रत्याशित सर्वर त्रुटि। एक्सपोनेंशियल बैकऑफ़ के साथ पुनः प्रयास करें।
502	Bad Gateway	अस्थायी सेवा व्यवधान। कुछ सेकंड के बाद पुनः प्रयास करें।
503	Service Unavailable	रखरखाव या अस्थायी आउटेज। स्थिति पृष्ठ की जाँच करें। Retry-After अंतराल के बाद पुनः प्रयास करें।
504	Gateway Timeout	अनुरोध बहुत लंबा हो गया। सर्वर ने इसे संसाधित किया हो सकता है। इडेंपोटेंसी की जाँच करें।

सर्वर त्रुटि उदाहरण (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "रखरखाव के कारण सेवा अस्थायी रूप से अनुपलब्ध।",
    "resolution": "कृपया 5 मिनट के बाद पुनः प्रयास करें। https://status.smartmoneyapi.com पर स्थिति ट्रैक करें"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

समस्या निवारण मार्गदर्शिका

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

समस्या: API कुंजी के साथ भी 401 त्रुटियाँ प्राप्त हो रही हैं।

समाधान:

सत्यापित करें कि API कुंजी "Bearer" उपसर्ग के साथ Authorization हेडर में शामिल है
जाँचें कि आपकी API कुंजी समाप्त या रद्द नहीं हुई है
सुनिश्चित करें कि आप सही कुंजी (प्रोडक्शन, स्टेजिंग, या डेवलपमेंट) का उपयोग कर रहे हैं
यदि वर्तमान कुंजी खो गई है तो अपने कंसोल से एक नई API कुंजी जनरेट करें

403 Forbidden - सुविधा उपलब्ध नहीं

समस्या: कुछ एंडपॉइंट्स पर 403 त्रुटियाँ प्राप्त हो रही हैं।

समाधान:

अपनी API टियर की जाँच करें। कुछ एंडपॉइंट्स के लिए Trader या Pro योजनाओं की आवश्यकता होती है
प्रीमियम सुविधाओं तक पहुँचने के लिए /pricing.html पर अपनी योजना अपग्रेड करें
सत्यापित करें कि API कुंजी में आवश्यक स्कोप सक्षम हैं
सपोर्ट से संपर्क करें यदि आपको लगता है कि आपके पास पहुँच होनी चाहिए

429 Too Many Requests - दर सीमित

समस्या: 429 त्रुटियाँ प्राप्त हो रही हैं और दर सीमित हो रहा है।

समाधान:

एक्सपोनेंशियल बैकऑफ़ पुनः प्रयास तर्क लागू करें (1s, 2s, 4s, आदि प्रतीक्षा करें)
रिडंडेंट API कॉल से बचने के लिए प्रतिक्रियाओं को कैश करें
रियल-टाइम डेटा के लिए REST एंडपॉइंट्स को पोल करने के बजाय WebSocket का उपयोग करें
उच्च कोटा (Trader 1,000/दिन, Pro 5,000/दिन) के लिए अपनी योजना अपग्रेड करें
जहाँ संभव हो एकल अनुरोध में कई क्वेरीज़ को बैच करें

400 Bad Request - अमान्य पैरामीटर

समस्या: गलत अनुरोधों के साथ 400 त्रुटियाँ प्राप्त हो रही हैं।

समाधान:

आवश्यक और वैकल्पिक पैरामीटर के लिए API दस्तावेज़ीकरण की जाँच करें
पैरामीटर प्रकारों (स्ट्रिंग्स बनाम नंबर्स, ऐरेज़ बनाम ऑब्जेक्ट्स) को सत्यापित करें
सुनिश्चित करें कि JSON मान्य और सही ढंग से फ़ॉर्मेटेड है
उचित पथ पैरामीटर के साथ सही एंडपॉइंट URLs का उपयोग करें
क्वेरी पैरामीटर नामों में टाइपो की जाँच करें

5xx सर्वर त्रुटियाँ - अस्थायी डाउनटाइम

समस्या: 500, 502, 503, या 504 त्रुटियाँ प्राप्त हो रही हैं।

समाधान:

सेवा स्थिति https://status.smartmoneyapi.com पर जाँचें
ऑटोमैटिक रिट्राई को एक्सपोनेंशियल बैकऑफ़ के साथ लागू करें (अधिकतम 5-10 प्रयास)
503 त्रुटियों के लिए पुनः प्रयास करने से पहले 30-60 सेकंड प्रतीक्षा करें
रिट्राई समय निर्धारित करने के लिए Retry-After हेडर का उपयोग करें
घटना सूचनाओं के लिए स्थिति पृष्ठ की सदस्यता लें

त्रुटि प्रतिक्रिया प्रारूप

सभी त्रुटि प्रतिक्रियाएँ एक सुसंगत प्रारूप का पालन करती हैं:

JSON

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "मानव-पठनीय त्रुटि संदेश",
    "details": {...},
    "resolution": "समस्या को हल करने के चरण"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

अधिक सहायता चाहिए?

हमारा API दस्तावेज़ीकरण देखें या अपनी त्रुटि कोड और अनुरोध विवरण के साथ समर्थन से संपर्क करें।

API संदर्भ

समर्थन प्राप्त करें

प्रश्न हैं? हमारा दस्तावेज़ीकरण देखें या समर्थन से संपर्क करें।

कंसोल खोलें