දෝෂ කේත සහ තත්ත්ව යොමුව
Smart Money API දෝෂ කේත, HTTP තත්ත්ව කේත සහ ගැටළු නිරාකරණ පියවර පිළිබඳ සවිස්තරාත්මක මාර්ගෝපදේශය. දෝෂ ප්රතිචාර තේරුම් ගෙන ඒකාබද්ධ කිරීමේ ගැටළු ඉක්මනින් විසඳන්න.
2xx සාර්ථකත්වයේ කේත
සාර්ථක ප්රතිචාර යනු ඉල්ලීම සාර්ථකව සකසන ලද බවයි.
| කේතය | තත්ත්වය | අර්ථය |
|---|---|---|
| 200 | හරි | ඉල්ලීම සාර්ථකයි. ප්රතිචාර ශරීරයේ ඉල්ලූ දත්ත අඩංගු වේ. |
| 201 | සාදන ලදි | සම්පත් සාර්ථකව නිර්මාණය කරන ලදී. ප්රතිචාරයේ නව සම්පත් ඇතුළත් වේ. |
| 204 | අන්තර්ගතය නැත | ඉල්ලීම සාර්ථකයි, නමුත් ආපසු ලබා දීමට අන්තර්ගතය නොමැත (උදා. DELETE). |
200 ප්රතිචාරයේ උදාහරණය
JSON
{
"success": true,
"data": {
"total": 42,
"positions": [...],
"pagination": {
"page": 1,
"limit": 50
}
},
"timestamp": "2026-03-21T14:35:22Z"
}
4xx ගැනුම්කරු දෝෂ කේත
ගැනුම්කරු දෝෂ යනු ඉල්ලීම වැරදි ලෙස සකස් කර ඇති හෝ අවලංගු වී ඇති බවයි. ඔබගේ ඉල්ලීම නිවැරදි කර නැවත උත්සාහ කරන්න.
| කේතය | තත්ත්වය | හේතුව |
|---|---|---|
| 400 | වැරදි ඉල්ලීම | වැරදි ඉල්ලීම් වාක්ය රචනය. විමසුම් පරාමිතීන්, ශීර්ෂ සහ ඉල්ලීම් ශරීරය පරීක්ෂා කරන්න. |
| 401 | අනවසරයෙන් | සත්යාපන අක්තපත්ර නැති හෝ අවලංගු වී ඇත. ඔබගේ API යතුර හෝ JWT ටෝකන් පරීක්ෂා කරන්න. |
| 402 | ගෙවීම අවශ්යයි | ඔබගේ දායකත්ව ගෙවීම අසාර්ථක විය. ඔබගේ ගිණුමේ බිල්පත් තොරතුරු යාවත්කාලීන කරන්න. |
| 403 | නොදෙනු ලැබේ | සත්යාපනය කර ඇති නමුත් මෙම සම්පත සඳහා අවසර නැත. ඔබගේ සැලැස්මට මෙම විශේෂාංගය ඇතුළත් නොවේ. |
| 404 | හමු නොවීය | සම්පත් නොපවතී. අවසාන ලක්ෂ්ය URL සහ පරාමිතීන් පරීක්ෂා කරන්න. |
| 429 | බොහෝ ඉල්ලීම් | ප්රමාණ සීමාව ඉක්මවා ඇත. නැවත උත්සාහ කිරීමට පෙර රැඳී සිටින්න. Retry-After ශීර්ෂය පරීක්ෂා කරන්න. |
| 422 | සකස් කළ නොහැකි ආයතනය | සත්යාපනය අසාර්ථක විය. ඉල්ලීම් පරාමිතීන් අවලංගු හෝ අවශ්ය ක්ෂේත්ර නැති වී ඇත. |
සත්යාපන දෝෂ උදාහරණ
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": "https://smartmoneyapi.com/console වෙතින් නව API යතුරක් ජනනය කරන්න"
},
"timestamp": "2026-03-21T14:35:22Z"
}
ප්රමාණ සීමා කිරීම (429)
ඔබ ඔබගේ API කොටස ඉක්මවා ගිය විට, සේවාදායකය 429 බොහෝ ඉල්ලීම් ආපසු ලබා දෙයි. ප්රමාණ සීමා තොරතුරු සඳහා ප්රතිචාර ශීර්ෂ පරීක්ෂා කරන්න:
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 | අභ්යන්තර දෝෂය | අනපේක්ෂිත සේවාදායක දෝෂය. ඝාතීය ආපසු යාම සමඟ නැවත උත්සාහ කරන්න. |
| 502 | වැරදි ද්වාරය | තාවකාලික සේවා බාධාව. තත්පර කිහිපයකට පසු නැවත උත්සාහ කරන්න. |
| 503 | සේවය නොලැබෙන | නඩත්තු හෝ තාවකාලික අක්රියතාවය. තත්ත්ව පිටුව පරීක්ෂා කරන්න. Retry-After විරාමයෙන් පසු නැවත උත්සාහ කරන්න. |
| 504 | ද්වාරයේ කාලය ඉක්මවා ඇත | ඉල්ලීම බොහෝ කල් ගත විය. සේවාදායකය එය සකසා ඇති. අනුප්රාප්තිකත්වය පරීක්ෂා කරන්න. |
සේවාදායක දෝෂ උදාහරණය (503)
JSON
{
"success": false,
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "නඩත්තුව හේතුවෙන් සේවය තාවකාලිකව ලබා ගත නොහැක.",
"resolution": "මිනිත්තු 5කට පසු නැවත උත්සාහ කරන්න. තත්ත්වය https://status.smartmoneyapi.com වෙත අවධානය කරන්න"
},
"timestamp": "2026-03-21T14:35:22Z"
}
ගැටළු නිරාකරණ මාර්ගෝපදේශය
401 අනවසරයෙන් - අවලංගු API යතුර
ගැටලුව: API යතුරක් සමඟ වුවද 401 දෝෂ ලැබෙයි.
විසඳුම්:
- API යතුර "Bearer" උපසර්ගය සමඟ Authorization ශීර්ෂයේ ඇතුළත් කර ඇති බව සත්යාපනය කරන්න
- ඔබගේ API යතුර කල් ඉකුත් වී නැති හෝ අවලංගු කර නැති බව පරීක්ෂා කරන්න
- ඔබ නිවැරදි යතුර භාවිතා කරන බව තහවුරු කරන්න (නිෂ්පාදන, පියවර, හෝ සංවර්ධන)
- වත්මන් යතුර අහිමි වී ඇත්නම් ඔබගේ කොන්සෝලයෙන් නව API යතුරක් ජනනය කරන්න
403 නොදෙනු ලැබේ - විශේෂාංගය නොලැබෙන
ගැටලුව: සමහර අවසාන ලක්ෂ්යවල 403 දෝෂ ලැබෙයි.
විසඳුම්:
- ඔබගේ API තරඟය පරීක්ෂා කරන්න. සමහර අවසාන ලක්ෂ්ය සඳහා Trader හෝ Pro සැලැස්ම අවශ්ය වේ
- වාණිජ ලක්ෂණ ප්රවේශ වීම සඳහා /pricing.html වෙත ඔබගේ සැලැස්ම උත්ශ්රේණි කරන්න
- API යතුරට අවශ්ය විෂය පථ සක්රීය කර ඇති බව සත්යාපනය කරන්න
- ඔබට ප්රවේශය ලැබිය යුතු යැයි සිතන්නේ නම් සහාය අමතන්න
429 බොහෝ ඉල්ලීම් - ප්රමාණ සීමා කර ඇත
ගැටලුව: 429 දෝෂ ලැබෙන අතර ප්රමාණ සීමා කර ඇත.
විසඳුම්:
- ඝාතීය ආපසු යාමේ නැවත උත්සාහ කිරීමේ තර්කය ක්රියාත්මක කරන්න (1s, 2s, 4s, ආදිය රැඳී සිටින්න)
- අනවශ්ය API ඇමතුම් වළක්වා ගැනීම සඳහා ප්රතිචාර කෑෂ් කරන්න
- REST අවසාන ලක්ෂ්ය පරීක්ෂා කිරීම වෙනුවට WebSocket භාවිතා කරන්න
- ඉහළ කොටස් සඳහා ඔබගේ සැලැස්ම උත්ශ්රේණි කරන්න (Trader 400/දින, Pro 4,000/දින)
- හැකි තැන බහු විමසුම් තනි ඉල්ලීම්වලට බැඳීම
400 වැරදි ඉල්ලීම - අවලංගු පරාමිතීන්
ගැටලුව: වැරදි ඉල්ලීම් සමඟ 400 දෝෂ ලැබෙයි.
විසඳුම්:
- අවශ්ය සහ විකල්ප පරාමිතීන් සඳහා API ලියකියවිලි පරීක්ෂා කරන්න
- පරාමිතීන් වර්ග සත්යාපනය කරන්න (පේළි වාර්තා සංඛ්යා, අරා සංසන්දනය කරන ලද වස්තු)
- 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 යොමුව