ឯកសារ API

ការណែនាំអំពីការសាកល្បង API និងបរិស្ថាន Sandbox

ធ្វើជាម្ចាស់ការសាកល្បងជាមួយបរិស្ថាន Sandbox បំពេញរបស់ Smart Money API។ អភិវឌ្ឍន៍ដោយគ្មានហានិភ័យដោយប្រើទិន្នន័យសាកល្បងដែលពិតប្រាកដ ការឆ្លើយតបដែលអាចកំណត់បាន និងកំណត់អត្រាដ៏អស្ចារ្យសម្រាប់ការពិសោធន៍។

បោះពុម្ភផ្សាយនៅថ្ងៃទី 21 ខែមីនា ឆ្នាំ 2026 • 14 នាទីអាន • ការអភិវឌ្ឍន៍

ទិដ្ឋភាពទូទៅនៃបរិស្ថាន Sandbox

Smart Money API ផ្តល់នូវបរិស្ថាន Sandbox ដែលមានលក្ខណៈពេញលេញសម្រាប់ការអភិវឌ្ឍន៍ និងការសាកល្បង។ Sandbox ឆ្លុះបញ្ចាំងពីរចនាសម្ព័ន្ធនៃ API ផលិតកម្ម ប៉ុន្តែប្រើទិន្នន័យសំយោគ និងកំណត់អត្រាដ៏អស្ចារ្យ ដែលអនុញ្ញាតឱ្យអ្នកអភិវឌ្ឍន៍ដោយចិត្តជ្រះថ្លាមុនពេលចេញផ្សាយ។

លក្ខណៈពិសេសសំខាន់៖

  • ដូចគ្នានឹងផលិតកម្ម — ចំណុចបញ្ចប់ដូចគ្នា ការផ្ទៀងផ្ទាត់ ទម្រង់ការឆ្លើយតប
  • ទិន្នន័យសាកល្បងតែប៉ុណ្ណោះ — មិនដែលប៉ះពាល់ដល់គណនីពិត ឬទីផ្សារស្រស់
  • កំណត់អត្រាខ្ពស់ — 10,000 សំណើ/ម៉ោង ប្រៀបធៀបនឹង 1,000 ក្នុងផលិតកម្ម
  • ការឆ្លើយតបដែលអាចកំណត់បាន — ឧបករណ៍សាកល្បងដែលមានភាពស្ថិតស្ថេរសម្រាប់ការសាកល្បងដែលអាចធ្វើម្តងទៀតបាន
  • គណនីដាច់ដោយឡែក — ដាច់ដោយឡែកពីទិន្នន័យអ្នកប្រើប្រាស់ផលិតកម្ម

ការអនុវត្តល្អបំផុត៖ ការអភិវឌ្ឍន៍ ការសាកល្បង និងការដាក់ជំហានទាំងអស់គួរតែប្រើបរិស្ថាន Sandbox។ ប្រើផលិតកម្មតែបន្ទាប់ពីការផ្ទៀងផ្ទាត់ Sandbox យ៉ាងហ្មត់ចត់។

លក្ខណៈពិសេសនៃ Sandbox

ទិន្នន័យសាកល្បងដែលពិតប្រាកដ

Sandbox មានទិន្នន័យទីផ្សាររូបិយប័ណ្ណដែលពិតប្រាកដដែលមិនផ្លាស់ប្តូរដោយចៃដន្យ៖

  • ទិន្នន័យទីផ្សារប្រវត្តិសាស្ត្រ (6 ខែនៃ OHLCV ដែលពិតប្រាកដ)
  • អាសយដ្ឋានកាបូបសាច់ប្រាក់ដែលមានលំនាំផ្លាស់ទីដែលស្ថិតស្ថេរ
  • អត្រាការផ្តល់ជំនួយដែលមានស្ថេរភាពដែលកំណត់ឡើងវិញរាល់ម៉ោង
  • លំនាំការលុបបំបាត់ដែលអាចកំណត់បានសម្រាប់ការសាកល្បងករណីចំណុច

លក្ខណៈពិសេសសម្រាប់ការសាកល្បង

លក្ខណៈពិសេសសាកល្បង
// សញ្ញាសាកល្បងដែលអាចកំណត់បាន
// សញ្ញាសាកល្បងទាំងអស់ចាប់ផ្តើមដោយ TEST_
TEST_BTC, TEST_ETH, TEST_SOL, ជាដើម។
// ពេលវេលាមានអានុភាពសម្រាប់ការធ្វើឱ្យស្រមៃនូវស្ថានភាព
GET /v1/derivatives/funding-heatmap?
timestamp=1234567890000 // ត្រឡប់ទិន្នន័យសាកល្បងដែលជាក់លាក់
// បង្ខំកំហុសសម្រាប់ការសាកល្បងការដោះស្រាយករណីលើកលែង
X-Test-Error: rate_limit_exceeded
X-Test-Error: service_unavailable

ឧបករណ៍សាកល្បង

  • ការកំណត់ទិន្នន័យឡើងវិញ — កំណត់គណនីសាកល្បងទាំងអស់ទៅជាស្ថានភាពដំបូង
  • ការគ្រប់គ្រងពេលវេលា — ធ្វើឱ្យស្រមៃនូវស្ថានភាពទីផ្សារផ្សេងៗ
  • ការបញ្ចូលកំហុស — បង្ខំការឆ្លើយតបកំហុសជាក់លាក់
  • ការសាកល្បងកំណត់អត្រា — បង្កើតការឆ្លើយតបកំណត់អត្រា
ទទួលបានកូនសោ API របស់អ្នកក្នុងរយៈពេល 30 វិនាទី

ត្រៀមខ្លួនរួចហើយក្នុងការសាងសង់? ទាញយកកូនសោ API ដោយឥតគិតថ្លៃ (50 ការហៅ/ថ្ងៃ គ្មានកាត) ហើយចាប់ផ្តើមទាញទិន្នន័យស្រស់អំពីកាបូបសាច់ប្រាក់ធំ ការផ្តល់ជំនួយ និងទិន្នន័យខ្សែសង្វាក់។

ទទួលបានកូនសោ API របស់អ្នក →

លិខិតសម្គាល់សាកល្បង

ការទទួលបានកូនសោ API សាកល្បង

បង្កើតគណនីសាកល្បងតាមរយៈផ្ទាំងគ្រប់គ្រងដើម្បីបង្កើតកូនសោ API សម្រាប់ Sandbox៖

ទម្រង់កូនសោសាកល្បង
// កូនសោសាកល្បងមានបុព្វបទខុសគ្នា
sk_test_1234567890abcdef // កូនសោ API សាកល្បង
sk_live_1234567890abcdef // កូនសោ API ផលិតកម្ម
// បញ្ជូនដោយស្វ័យប្រវត្តិទៅបរិស្ថានដែលសមស្រប
GET https://api.smartmoneyapi.com/v1/whales
-H "Authorization: Bearer sk_test_xxx"
# បញ្ជូនទៅ Sandbox ដោយស្វ័យប្រវត្តិ

កូនសោសាកល្បងដែលបានកំណត់ជាមុន

ប្រើកូនសោសាកល្បងសាធារណៈទាំងនេះសម្រាប់ការពិសោធន៍រហ័ស (មានកំណត់អត្រា)៖

កូនសោ ការអនុញ្ញាត កំណត់
sk_test_demo អានទាំងអស់ 100/ម៉ោង
sk_test_trader អាន + ការជូនដំណឹង 500/ម៉ោង
sk_test_pro ការចូលប្រើពេញលេញ 5000/ម៉ោង

កុំដោយកូនសោសាកល្បងក្នុងផលិតកម្ម។ ពួកគេមានមុខងារកំណត់ និងកំណត់អត្រា។

ទិន្នន័យសាកល្បង និងឧបករណ៍សាកល្បង

សញ្ញាសាកល្បងដែលមាន

Sandbox រួមបញ្ចូលសញ្ញាការផ្លាស់ប្តូរសាកល្បងទាំងនេះជាមួយទិន្នន័យប្រវត្តិសាស្ត្រដែលពិតប្រាកដ៖

សញ្ញាសាកល្បង
// គូរូបិយប័ណ្ណ
TEST_BTCUSDT, TEST_ETHUSDT, TEST_BNBUSDT
TEST_SOLSDT, TEST_ARBUSDT, TEST_OPUSDT
// ស្វែងរកសញ្ញាសាកល្បង
GET /v1/symbols?test_only=true

កាបូបសាច់ប្រាក់សាកល្បង

កាបូបសាច់ប្រាក់សាកល្បងដែលបានកំណត់ជាមុនជាមួយនឹងឥរិយាបថដែលអាចកំណត់បាន៖

  • កាបូបសាច់ប្រាក់សារប្រមូល — ទិញជាប្រចាំ ល្អសម្រាប់ការសាកល្បងឡើង
  • កាបូបសាច់ប្រាក់ចែកចាយ — លក់ជាប្រចាំ ល្អសម្រាប់ការសាកល្បងធ្លាក់
  • កាបូបសាច់ប្រាក់រំញ័រ — ផ្លាស់ប្តូរទិញ/លក់ ល្អសម្រាប់ការសាកល្បងក្នុងជួរ
  • កាបូបសាច់ប្រាក់ភាពមិនស្ថិតស្ថេរ — ប្រតិបត្តិការធំៗដោយចៃដន្យសម្រាប់ការសាកល្បងស្ត្រេស

ការកំណត់ទិន្នន័យសាកល្បងឡើងវិញ

កំណត់ទិន្នន័យសាកល្បងឡើងវិញ
// កំណត់គណនីសាកល្បងទាំងអស់ទៅជាស្ថានភាពដំបូង
POST /v1/test/reset
-H "Authorization: Bearer sk_test_xxx"
// កំណត់ធនធានជាក់លាក់
POST /v1/test/reset?resource=whales
// ការឆ្លើយតប
{
"status": "reset_complete",
"timestamp": 1709980800000
}

Sandbox Endpoints

Base URLs

Environment URLs
// Sandbox (test mode)
https://api-test.smartmoney.io/v1
// Or use query parameter
https://api.smartmoneyapi.com/v1?environment=sandbox
// Production (live mode)
https://api.smartmoneyapi.com/v1

Sandbox-Only Endpoints

Endpoint Purpose
POST /test/reset Reset test data to initial state
POST /test/inject-error Inject specific error for testing
POST /test/simulate-time Simulate different market conditions
GET /test/status Check sandbox environment health

Response Mocking

Injecting Test Errors

Force specific error responses for exception handling testing:

Error Injection
// Test rate limit handling
GET /v1/whales?X-Test-Error=rate_limit_exceeded
// Test service unavailability
GET /v1/whales?X-Test-Error=service_unavailable
// Test authentication failure
GET /v1/whales?X-Test-Error=invalid_key
// Test timeout
GET /v1/whales?X-Test-Error=timeout

Available Test Errors

Error Code HTTP Status Use Case
invalid_key 401 Auth error handling
rate_limit_exceeded 429 Backoff logic testing
not_found 404 Missing resource handling
service_unavailable 503 Retry logic testing
timeout 504 Timeout handling

Sandbox Rate Limits

Rate Limit Tiers

Environment Limit/Hour Burst Purpose
Sandbox 10,000 500/min Development & testing
Production Free 1,000 50/min Hobby projects
Production Trader 10,000 400/min Professional trading
Production Pro 50,000 1000/min High-frequency systems

Testing Rate Limit Handling

Rate Limit Testing
// Trigger rate limit response in sandbox
curl -H "X-Test-Error: rate_limit_exceeded" \
https://api-test.smartmoney.io/v1/whales
// Response includes retry headers
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709984400
Retry-After: 3600

Testing Strategies

Unit Testing with Fixtures

Python Unit Test
import unittest
import requests
class TestSmartMoneyAPI(unittest.TestCase):
def setUp(self):
self.api_key = 'sk_test_demo'
self.base_url = 'https://api-test.smartmoney.io/v1'
def test_whale_tracking(self):
response = requests.get(
f'{self.base_url}/whales/TEST_BTC',
headers={'Authorization': f'Bearer {self.api_key}'}
)
self.assertEqual(response.status_code, 200)
self.assertIn('whales', response.json())

Integration Testing

Test full workflow in sandbox before production deployment:

  1. Deploy to staging with sandbox credentials
  2. Run full test suite against sandbox
  3. Test error handling with error injection
  4. Verify rate limiting behavior
  5. Check response time and latency
  6. Only then promote to production

Load Testing

Load Test with Apache Bench
// Sandbox allows high load testing
ab -n 5000 -c 100 \
-H "Authorization: Bearer sk_test_pro" \
https://api-test.smartmoney.io/v1/whales/TEST_BTC

CI/CD Integration

GitHub Actions Example

.github/workflows/test.yml
name: API Tests
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- run: pip install requests pytest
- env:
SMARTMONEY_API_KEY: ${{ secrets.TEST_API_KEY }}
SMARTMONEY_ENV: sandbox
run: pytest tests/

Environment Configuration

ប្រើអថេរបរិស្ថានដើម្បីប្តូររវាង sandbox និង production៖

ការរៀបចំបរិស្ថាន
// .env.sandbox
SMARTMONEY_API_KEY=sk_test_demo
SMARTMONEY_API_URL=https://api-test.smartmoney.io/v1
SMARTMONEY_ENV=sandbox
// .env.production
SMARTMONEY_API_KEY=sk_live_xxxx
SMARTMONEY_API_URL=https://api.smartmoneyapi.com/v1
SMARTMONEY_ENV=production

ការដោះស្រាយបញ្ហា

បញ្ហាទូទៅ

សោរការសាកល្បងមិនដំណើរការ

បញ្ហា៖ ទទួលបានការបដិសេធមិនមានសិទ្ធិ 401 ជាមួយសោរការសាកល្បង

ដំណោះស្រាយ៖

  • ផ្ទៀងផ្ទាត់ថាសោចាប់ផ្តើមដោយ sk_test_ (មិនមែន sk_live_)
  • ពិនិត្យទ្រង់ទ្រាយក្បាលអនុញ្ញាត៖ "Bearer sk_test_xxx"
  • ធានាថាប្រើចំណុចបញ្ចប់សាកល្បង៖ api-test.smartmoney.io
  • សោរការសាកល្បងអាចហួសពីដែនកំណត់អត្រា

ទិន្នន័យមិនបានកំណត់ឡើងវិញ

បញ្ហា៖ ទិន្នន័យសាកល្បងមិនបានកំណត់ឡើងវិញបន្ទាប់ពី POST /test/reset

ដំណោះស្រាយ៖

  • ការកំណត់ឡើងវិញអាចចំណាយពេលរហូតដល់ 30 វិនាទីដើម្បីផ្សព្វផ្សាយ
  • ពិនិត្យស្ថានភាព sandbox ជាមួយ GET /test/status
  • ផ្ទៀងផ្ទាត់ថាប្រើសោ API សាកល្បងត្រឹមត្រូវ
  • ទាក់ទងការគាំទ្របើការបន្ត

ដែនកំណត់អត្រាក្នុង Sandbox

បញ្ហា៖ បុកដែនកំណត់អត្រាក្នុង sandbox (មិនគួរកើតឡើង)

ដំណោះស្រាយ៖

  • ផ្ទៀងផ្ទាត់ថាប្រើសោ sk_test_pro (10,000/ម៉ោង)
  • ពិនិត្យក្បាល X-RateLimit-Remaining
  • រង់ចាំដែនកំណត់ម៉ោង ឬប្រើគណនីសាកល្បងផ្សេង
  • ទាក់ទងការគាំទ្រសម្រាប់ការបង្កើនដែនកំណត់អត្រាបណ្តោះអាសន្ន

ចាប់ផ្តើមសាកល្បងថ្ងៃនេះ

ប្រើបរិស្ថាន sandbox បំពានរបស់យើងសម្រាប់ការអភិវឌ្ឍន៍ដាច់ដោយឡែកដោយសុវត្ថិភាព។ ទិន្នន័យសាកល្បងដែលកំណត់ជាក់លាក់ ដែនកំណត់អត្រាខ្ពស់ និងលក្ខណៈពិសេសពេញលេញដូចនឹង production។

ទទួលបានព័ត៌មានផ្ទៀងផ្ទាត់សាកល្បង
គម្រោងទាំងអស់រួមបញ្ចូលការចូលប្រើ sandbox។ គ្មានការចំណាយបន្ថែមទេ។

ធនធានពាក់ព័ន្ធ

មគ្គុទ្ទេសក៍ផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ →

ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ API និងការគ្រប់គ្រងសោ

ឯកសារយោង REST API →

ឯកសារចំណុចបញ្ចប់ API ពេញលេញ

កូដកំហុស →

ការដោះស្រាយកំហុស និងកូដឆ្លើយតប
ចាប់ផ្តើមដោយឥតគិតថ្លៃ - 50 ការហៅ/ថ្ងៃ គ្មានកាត

ទទួលបានលំហូរប្រាក់ដ៏ធំ ការផ្តល់មូលនិធិ ការចាប់អារម្មណ៍បើក និងទិន្នន័យលើខ្សែសង្វាក់នៅលើ 3 វិនិយោគពី API តែមួយ។ កម្រិតឥតគិតថ្លៃ គ្មានកាតឥណទាន ដំឡើងថ្មីគ្រប់ពេល។

ចាប់ផ្តើមដោយឥតគិតថ្លៃ →
សាកល្បងកុងសូល API ផ្ទាល់ → (មិនត្រូវការគណនី)