កូដកំហុស និងស្ថានភាពយោង

ការណែនាំពេញលេញអំពីកូដកំហុស Smart Money API កូដស្ថានភាព HTTP និងជំហានដោះស្រាយបញ្ហា។ យល់ពីការឆ្លើយតបកំហុស និងដោះស្រាយបញ្ហាការរួមបញ្ចូលយ៉ាងឆាប់រហ័ស។

កូដជោគជ័យ 2xx

ការឆ្លើយតបជោគជ័យបង្ហាញថាសំណើត្រូវបានដំណើរការដោយជោគជ័យ។

កូដ	ស្ថានភាព	អត្ថន័យ
200	OK	សំណើទទួលបានជោគជ័យ។ តួការឆ្លើយតបមានទិន្នន័យដែលបានស្នើសុំ។
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": "បង្កើតកូដ API ថ្មីពីកុងសូលរបស់អ្នកនៅ https://smartmoneyapi.com/console"
  },
  "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 មិនត្រឹមត្រូវ

បញ្ហា៖ ទទួលបានកំហុស 401 ទោះបីមានកូដ API។

ដំណោះស្រាយ៖

ផ្ទៀងផ្ទាត់ថាកូដ API ត្រូវបានដាក់ក្នុងបឋមកថា Authorization ជាមួយនឹងបុព្វបទ "Bearer"
ពិនិត្យថាកូដ API របស់អ្នកមិនបានផុតកំណត់ឬត្រូវបានលុបចោល
ធានាថាអ្នកកំពុងប្រើកូដត្រឹមត្រូវ (ផលិតផល ស្តេយ៍ ឬការអភិវឌ្ឍន៍)
បង្កើតកូដ API ថ្មីពីកុងសូលរបស់អ្នកប្រសិនបើកូដបច្ចុប្បន្នបាត់

403 ត្រូវបានបដិសេធ - លក្ខណៈពិសេសមិនអាចប្រើបាន

បញ្ហា៖ ទទួលបានកំហុស 403 លើចំណុចបញ្ចប់ជាក់លាក់។

ដំណោះស្រាយ៖

ពិនិត្យកម្រិត API របស់អ្នក។ ចំណុចបញ្ចប់ខ្លះតម្រូវឱ្យមានផែនការ Trader ឬ Pro
ធ្វើឱ្យប្រសើរឡើងផែនការរបស់អ្នកនៅ /pricing.html ដើម្បីចូលប្រើលក្ខណៈពិសេសពីម៉ាស៊ីន
ផ្ទៀងផ្ទាត់ថាកូដ API មានវិសាលភាពដែលត្រូវការបានបើក
ទាក់ទងការគាំទ្រប្រសិនបើអ្នកគិតថាអ្នកគួរតែមានការចូលប្រើ

429 សំណើច្រើនពេក - ត្រូវបានកំណត់អត្រា

បញ្ហា៖ ទទួលបានកំហុស 429 និងត្រូវបានកំណត់អត្រា។

ដំណោះស្រាយ៖

អនុវត្តតក្កការព្យាយាមម្តងទៀតដោយអិចស្ប៉ូណង់ស្យែល (រង់ចាំ 1s, 2s, 4s, ជាដើម)
ផ្ទុកការឆ្លើយតបដើម្បីជៀសវាងការហៅ API ស្របគ្នា
ប្រើ WebSocket សម្រាប់ទិន្នន័យពេលវេលាពិតជំនួសឱ្យការស្ទង់ចំណុចបញ្ចប់ REST
ធ្វើឱ្យប្រសើរឡើងផែនការរបស់អ្នកសម្រាប់កំណត់អត្រាខ្ពស់ជាង (Trader 1,000/ថ្ងៃ, Pro 5,000/ថ្ងៃ)
ធ្វើការស្ទង់ច្រើនជាសំណើតែមួយដែលអាចធ្វើទៅបាន

400 សំណើមិនត្រឹមត្រូវ - ប៉ារ៉ាម៉ែត្រមិនត្រឹមត្រូវ

បញ្ហា៖ ទទួលបានកំហុស 400 ជាមួយនឹងសំណើមានកំហុស។

ដំណោះស្រាយ៖

ពិនិត្យឯកសារ API សម្រាប់ប៉ារ៉ាម៉ែត្រដែលត្រូវការ និងជាជម្រើស
ផ្ទៀងផ្ទាត់ប្រភេទប៉ារ៉ាម៉ែត្រ (ខ្សែអក្សរ លេខ អារេ វត្ថុ)
ធានាថា JSON មានសុពលភាព និងមានទម្រង់ត្រឹមត្រូវ
ប្រើ URL ចំណុចបញ្ចប់ត្រឹមត្រូវជាមួយនឹងប៉ារ៉ាម៉ែត្រផ្លូវត្រឹមត្រូវ
ពិនិត្យកំហុសអក្សរក្នុងឈ្មោះប៉ារ៉ាម៉ែត្រសំណួរ

កំហុសសឺវែ 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

ទទួលការគាំទ្រ

មានសំណួរទេ? ពិនិត្យឯកសាររបស់យើង ឬទាក់ទងការគាំទ្រ។

បើក Console