त्रुटि कोड और प्रबंधन
API त्रुटियों को समझें और संभालें
त्रुटि प्रतिक्रिया प्रारूप
सभी त्रुटि प्रतिक्रियाएं एक समान प्रारूप का उपयोग करती हैं:
{
"error": {
"code": "ERROR_CODE",
"message": "मानव-पठनीय त्रुटि संदेश",
"details": "अतिरिक्त संदर्भ (वैकल्पिक)"
}
}💡 error.code को स्थिर शर्त के रूप में उपयोग करें (त्रुटि संदेश बदल सकता है)
HTTP स्थिति कोड
200 OK
अनुरोध सफल रहा
201 Created
संसाधन सफलतापूर्वक बनाया गया
400 Bad Request
अनुरोध पैरामीटर अमान्य हैं
{
"code": "INVALID_REQUEST",
"message": "अनुरोध प्रारूप अमान्य है"
}401 Unauthorized
प्रमाणीकरण नहीं हुआ या API कुंजी अमान्य है
{
"code": "UNAUTHORIZED",
"message": "अमान्य या समाप्त API कुंजी"
}403 Forbidden
अपर्याप्त खाता शेष या कोई अनुमति नहीं
{
"code": "INSUFFICIENT_BALANCE",
"message": "अपर्याप्त खाता शेष"
}404 Not Found
संसाधन मौजूद नहीं है
{
"code": "ORDER_NOT_FOUND",
"message": "आदेश मौजूद नहीं है"
}409 Conflict
संसाधन विरोध
{
"code": "ADDRESS_EXISTS",
"message": "पता पहले से मौजूद है"
}429 Too Many Requests
API कुंजी दर सीमा पार हो गई
{
"code": "RATE_LIMITED",
"message": "दर सीमा पार हो गई"
}500 Internal Server Error
आंतरिक सर्वर त्रुटि
{
"code": "INTERNAL_ERROR",
"message": "एक अप्रत्याशित त्रुटि हुई"
}503 Service Unavailable
सेवा अस्थायी रूप से अनुपलब्ध है (रखरखाव चल रहा है)
{
"code": "SERVICE_UNAVAILABLE",
"message": "सेवा अस्थायी रूप से अनुपलब्ध है"
}सामान्य त्रुटि कोड
| Error Code | Status | Description | Solution |
|---|---|---|---|
| UNAUTHORIZED | 401 | अमान्य, समाप्त या रद्द API कुंजी | जांचें कि API कुंजी सही है, आवश्यक होने पर एक नई बनाएं |
| INSUFFICIENT_BALANCE | 403 | अपर्याप्त खाता शेष | खाता रिचार्ज करें |
| INVALID_ADDRESS | 400 | अमान्य TRON पता प्रारूप | जांचें कि पता एक मान्य TRON पता है (T से शुरू होता है) |
| INVALID_ENERGY_AMOUNT | 400 | अमान्य ऊर्जा मात्रा | ऊर्जा मात्रा एक सकारात्मक पूर्णांक होनी चाहिए, USDT ट्रांसफर के लिए 65000 अनुशंसित |
| INVALID_DURATION | 400 | अमान्य किराया अवधि | एक मान्य अवधि का उपयोग करें: 1H, 1D, 3D, 7D, 14D, 30D |
| ORDER_NOT_FOUND | 404 | कोई आदेश नहीं | जांचें कि आदेश ID सही है |
| ADDRESS_EXISTS | 409 | पता पहले से मौजूद है | जांचें कि पता पहले से जोड़ा गया है या मौजूदा पते का उपयोग करें |
| RATE_LIMITED | 429 | API कुंजी दर सीमा पार हो गई (वर्तमान में केवल POST /v1/wallet/recharges पर लागू) | एक्सपोनेंशियल बैकऑफ के साथ पुनः प्रयास करें या अनुरोध दर कम करें |
प्रबंधन के तरीके
| Error | Handling |
|---|---|
| 401 UNAUTHORIZED | API कुंजी की जांच करें/रोटेट करें |
| 403 INSUFFICIENT_BALANCE | रिचार्ज करें या अनुरोधित मात्रा कम करें |
| 409 ADDRESS_EXISTS | क्वेरी/आइडमपोटेंट प्रोसेसिंग पर स्विच करें |
| 429 RATE_LIMITED | प्रतीक्षा के साथ पुनः प्रयास करें (यदि उपलब्ध हो तो Retry-After का पालन करें, अन्यथा एक्सपोनेंशियल बैकऑफ का उपयोग करें) |
| 5xx | पुनः प्रयास करें + अनुरोध संदर्भ लॉग करें |
पुनः प्रयास दिशानिर्देश
- • अधिकतम पुनः प्रयास: 3 बार
- • प्रतीक्षा: एक्सपोनेंशियल (1 सेकंड, 2 सेकंड, 4 सेकंड...)
- • केवल 429/5xx के साथ पुनः प्रयास करें
- • 4xx (क्लाइंट-साइड त्रुटियों) के साथ पुनः प्रयास न करें