ລະຫັດຜິດພາດ & ການອ້າງອີງສະຖານະ
ຄູ່ມືສົມບູນກ່ຽວກັບລະຫັດຜິດພາດ 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 key ຫຼື JWT token ຂອງທ່ານ. |
| 402 | Payment Required | ການຈ່າຍເງິນສະມາຊິກຂອງທ່ານລົ້ມເຫຼວ. ອັບເດດຂໍ້ມູນການຈ່າຍເງິນໃນບັນຊີຂອງທ່ານ. |
| 403 | Forbidden | ຢືນຢັນຕົວຕົນແລ້ວແຕ່ບໍ່ມີສິດເຂົ້າເຖິງຊັບພະຍາກອນນີ້. ແຜນຂອງທ່ານບໍ່ລວມເອົາຄຸນສົມບັດນີ້. |
| 404 | Not Found | ຊັບພະຍາກອນບໍ່ມີຢູ່. ກວດສອບ URL endpoint ແລະພາຣາມີເຕີ. |
| 429 | Too Many Requests | ເກີນຈຳກັດອັດຕາສ່ວນ. ລໍຖ້າກ່ອນລອງໃໝ່. ກວດສອບຫົວຂໍ້ Retry-After. |
| 422 | Unprocessable Entity | ການກວດສອບລົ້ມເຫຼວ. ພາຣາມີເຕີຄຳຂໍບໍ່ຖືກຕ້ອງ ຫຼືຂາດຟິວທີ່ຈຳເປັນ. |
ຕົວຢ່າງຜິດພາດການຢືນຢັນຕົວຕົນ
ຂາດ API Key (401)
JSON
{
"success": false,
"error": {
"code": "AUTH_MISSING_KEY",
"message": "ບໍ່ມີຂໍ້ມູນຢືນຢັນຕົວຕົນ.",
"resolution": "ເພີ່ມ API key ຂອງທ່ານໃນຫົວຂໍ້ Authorization: Authorization: Bearer sk_live_..."
},
"timestamp": "2026-03-21T14:35:22Z"
}
API Key ບໍ່ຖືກຕ້ອງ (401)
JSON
{
"success": false,
"error": {
"code": "AUTH_INVALID_KEY",
"message": "API key ບໍ່ຖືກຕ້ອງ ຫຼືໝົດອາຍຸ.",
"resolution": "ສ້າງ API key ໃໝ່ຈາກຄອນໂຊນຂອງທ່ານທີ່ 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
ຜິດພາດເຊີບເວີຊີ້ບອກວ່າມີບັນຫາຢູ່ດ້ານຂອງພວກເຮົາ. ເຫຼົ່ານີ້ເປັນຊົ່ວຄາວ ແລະປົກກະຕິຈະແກ້ໄຂໄດ້ໄວ. ນຳໃຊ້ຕະລິກການລອງໃໝ່ແບບ exponential backoff.
| ລະຫັດ | ສະຖານະ | ການດຳເນີນການ |
|---|---|---|
| 500 | Internal Error | ຜິດພາດເຊີບເວີທີ່ບໍ່ຄາດຄິດ. ລອງໃໝ່ໂດຍໃຊ້ exponential backoff. |
| 502 | Bad Gateway | ການລົບກວນບໍລິການຊົ່ວຄາວ. ລອງໃໝ່ຫຼັງຈາກບໍ່ດົນ. |
| 503 | Service Unavailable | ການບຳລຸງຮັກສາ ຫຼືການລົບກວນຊົ່ວຄາວ. ກວດສອບໜ້າສະຖານະ. ລອງໃໝ່ຫຼັງຈາກຊ່ວງເວລາ Retry-After. |
| 504 | Gateway Timeout | ຄຳຂໍໃຊ້ເວລາດົນເກີນໄປ. ເຊີບເວີອາດຈະປະມວນຜົນມັນແລ້ວ. ກວດສອບ idempotency. |
ຕົວຢ່າງຜິດພາດເຊີບເວີ (503)
JSON
{
"success": false,
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "ບໍລິການບໍ່ສາມາດໃຊ້ງານໄດ້ຊົ່ວຄາວເນື່ອງຈາກການບຳລຸງຮັກສາ.",
"resolution": "ກະລຸນາລອງໃໝ່ຫຼັງຈາກ 5 ນາທີ. ຕິດຕາມສະຖານະທີ່ https://status.smartmoneyapi.com"
},
"timestamp": "2026-03-21T14:35:22Z"
}
ຄູ່ມືການແກ້ໄຂບັນຫາ
401 Unauthorized - API Key ບໍ່ຖືກຕ້ອງ
ບັນຫາ: ໄດ້ຮັບຜິດພາດ 401 ເຖິງແມ່ນວ່າມີ API key.
ວິທີແກ້ໄຂ:
- ຢືນຢັນວ່າ API key ຖືກເພີ່ມໃນຫົວຂໍ້ Authorization ພ້ອມຄຳນຳໜ້າ "Bearer"
- ກວດສອບວ່າ API key ຂອງທ່ານຍັງບໍ່ໝົດອາຍຸ ຫຼືຖືກຍົກເລີກ
- ໃຫ້ແນ່ໃຈວ່າທ່ານໃຊ້ກະແຈທີ່ຖືກຕ້ອງ (ການຜະລິດ, staging, ຫຼືການພັດທະນາ)
- ສ້າງ API key ໃໝ່ຈາກຄອນໂຊນຂອງທ່ານຖ້າກະແຈປະຈຸບັນສູນຫາຍ
403 Forbidden - ຄຸນສົມບັດບໍ່ມີ
ບັນຫາ: ໄດ້ຮັບຜິດພາດ 403 ກ່ຽວກັບ endpoint ບາງຢ່າງ.
ວິທີແກ້ໄຂ:
- ກວດສອບລະດັບ API ຂອງທ່ານ. endpoint ບາງຢ່າງຕ້ອງການແຜນ Trader ຫຼື Pro
- ອັບເກຣດແຜນຂອງທ່ານທີ່ /pricing.html ເພື່ອເຂົ້າເຖິງຄຸນສົມບັດພິເສດ
- ຢືນຢັນວ່າ API key ມີຂອບເຂດທີ່ຕ້ອງການເປີດໃຊ້
- ຕິດຕໍ່ຝ່າຍຊ່ວຍເຫຼືອຖ້າທ່ານເຊື່ອວ່າຄວນມີການເຂົ້າເຖິງ
429 Too Many Requests - ຈຳກັດອັດຕາສ່ວນ
ບັນຫາ: ໄດ້ຮັບຜິດພາດ 429 ແລະຖືກຈຳກັດອັດຕາສ່ວນ.
ວິທີແກ້ໄຂ:
- ນຳໃຊ້ຕະລິກການລອງໃໝ່ແບບ exponential backoff (ລໍຖ້າ 1s, 2s, 4s, ແລະອື່ນໆ)
- ເກັບຂໍ້ມູນການຕອບຮັບເພື່ອຫຼີກເວັ້ນການເອີ້ນ API ຊ້ຳຊ້ອນ
- ໃຊ້ WebSocket ສຳລັບຂໍ້ມູນແບບ real-time ແທນທີ່ຈະ polling REST endpoints
- ອັບເກຣດແຜນຂອງທ່ານເພື່ອໃຫ້ໄດ້ຈຳນວນສູງຂຶ້ນ (Trader 1,000/ມື້, Pro 5,000/ມື້)
- ຈັດການຄຳຖາມຫຼາຍຢ່າງເປັນຄຳຂໍດຽວໃນບ່ອນທີ່ເປັນໄປໄດ້
400 Bad Request - ພາຣາມີເຕີບໍ່ຖືກຕ້ອງ
ບັນຫາ: ໄດ້ຮັບຜິດພາດ 400 ກັບຄຳຂໍທີ່ບໍ່ຖືກຕ້ອງ.
ວິທີແກ້ໄຂ:
- ກວດສອບເອກະສານ API ສຳລັບພາຣາມີເຕີທີ່ຕ້ອງການ ແລະເລືອກ
- ຢືນຢັນປະເພດພາຣາມີເຕີ (ຂໍ້ຄວາມ vs ຕົວເລກ, ອາເຣ vs ວັດຖຸ)
- ໃຫ້ແນ່ໃຈວ່າ JSON ຖືກຕ້ອງ ແລະຈັດຮູບແບບຢ່າງເໝາະສົມ
- ໃຊ້ URL endpoint ທີ່ຖືກຕ້ອງພ້ອມພາຣາມີເຕີ path ທີ່ເໝາະສົມ
- ກວດສອບການພິມຜິດໃນຊື່ພາລາມິເຕີ
ຂໍ້ຜິດພາດດ້ານເຊີບເວີ 5xx - ການລົ້ມລະບາຍຊົ່ວຄາວ
ບັນຫາ: ກຳລັງໄດ້ຮັບຂໍ້ຜິດພາດ 500, 502, 503, ຫຼື 504.
ວິທີແກ້ໄຂ:
- ກວດສອບສະຖານະບໍລິການທີ່ https://status.smartmoneyapi.com
- ປະຕິບັດການລອງໃໝ້ອັດຕະໂນມັດດ້ວຍການຖອຍຫຼັງແບບເປີເຊັນ (ສູງສຸດ 5-10 ຄັ້ງ)
- ລໍຖ້າ 30-60 ວິນາທີກ່ອນລອງໃໝ້ຂໍ້ຜິດພາດ 503
- ໃຊ້ຫົວຂໍ້ Retry-After ເພື່ອກຳນົດເວລາລອງໃໝ້
- ສະໝັກຮັບການແຈ້ງເຫດຈາກໜ້າສະຖານະ
ຮູບແບບການຕອບຂໍ້ຜິດພາດ
ການຕອບຂໍ້ຜິດພາດທັງໝົດມີຮູບແບບຄືກັນ:
JSON
{
"success": false,
"error": {
"code": "ERROR_CODE",
"message": "ຂໍ້ຄວາມຂໍ້ຜິດພາດທີ່ອ່ານໄດ້",
"details": {...},
"resolution": "ຂັ້ນຕອນແກ້ໄຂບັນຫາ"
},
"timestamp": "2026-03-21T14:35:22Z"
}
ຕ້ອງການຄວາມຊ່ວຍເຫຼືອເພີ່ມເຕີມ?
ກວດເບິ່ງເອກະສານ API ຂອງພວກເຮົາຫຼືຕິດຕໍ່ຝ່າຍຊ່ວຍເຫຼືອດ້ວຍລະຫັດຂໍ້ຜິດພາດແລະລາຍລະອຽດການຮຽກຂໍຂອງທ່ານ.
ອ້າງອີງ API