பிழை குறியீடுகள் & நிலை குறிப்பு

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": "உங்கள் API விசையை Authorization தலைப்பில் சேர்க்கவும்: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

தவறான API விசை (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "தவறான அல்லது காலாவதியான API விசை.",
    "resolution": "உங்கள் கன்சோலில் இருந்து புதிய API விசையை உருவாக்கவும் https://smartmoneyapi.com/console"
  },
  "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/மாதம், 400 கோரிக்கைகள்/நாள்) அல்லது Pro ($79/மாதம், 4,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 பிழைகள் மற்றும் விகித வரம்பு கிடைக்கின்றன.

தீர்வுகள்:

அதிவேக பேக்அஃப் மீண்டும் முயற்சி தர்க்கத்தை செயல்படுத்தவும் (1வி, 2வி, 4வி போன்றவற்றில் காத்திருக்கவும்)
மீண்டும் மீண்டும் API அழைப்புகளைத் தவிர்ப்பதற்கான பதில்களை கேச் செய்யவும்
REST முடிவு புள்ளிகளைப் பதிலிடுவதற்கு பதிலாக நிகழ்நேர தரவுக்கு WebSocket ஐப் பயன்படுத்தவும்
அதிக கோட்டாக்களுக்கு உங்கள் திட்டத்தை மேம்படுத்தவும் (Trader 1,000/நாள், Pro 5,000/நாள்)
முடிந்தவரை பல வினவல்களை ஒற்றை கோரிக்கைகளாக தொகுக்கவும்

400 Bad Request - தவறான அளவுருக்கள்

சிக்கல்: தவறான கோரிக்கைகளுடன் 400 பிழைகள் பெறப்படுகின்றன.

தீர்வுகள்:

தேவையான மற்றும் விருப்ப அளவுருக்களுக்கான API ஆவணங்களை சரிபார்க்கவும்
அளவுரு வகைகளை சரிபார்க்கவும் (சரங்கள் vs எண்கள், வரிசைகள் vs பொருள்கள்)
JSON செல்லுபடியாகும் மற்றும் சரியாக வடிவமைக்கப்பட்டுள்ளதா என்பதை உறுதிப்படுத்தவும்
சரியான முடிவு புள்ளி URL களை சரியான பாதை அளவுருக்களுடன் பயன்படுத்தவும்
வினவல் அளவுரு பெயர்களில் தட்டச்சுப் பிழைகளை சரிபார்க்கவும்

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 குறிப்பு

ஆதரவைப் பெறவும்

கேள்விகள் உள்ளதா? எங்கள் ஆவணத்தை சரிபார்க்கவும் அல்லது ஆதரவைத் தொடர்பு கொள்ளவும்.

கன்சோலைத் திறக்கவும்