ເອກະສານ 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 ມີຂໍ້ມູນຕະຫຼາດ cryptocurrency ທີ່ເປັນຈິງທີ່ບໍ່ປ່ຽນແປງແບບສຸ່ມ:

  • ຂໍ້ມູນຕະຫຼາດປະຫວັດສາດ (6 ເດືອນຂອງ OHLCV ທີ່ເປັນຈິງ)
  • ທີ່ຢູ່ກະເປົາ whale ທີ່ຄົງທີ່ກັບຮູບແບບການເຄື່ອນໄຫວທີ່ສອດຄ່ອງ
  • ອັດຕາການສະໜັບສະໜູນທີ່ຄົງທີ່ທີ່ຣີເຊັດທຸກໆຊົ່ວໂມງ
  • ຮູບແບບການປິດບັນຊີທີ່ກຳນົດໄວ້ສຳລັບການທົດສອບເສັ້ນທາງຂອບ

ຄຸນສົມບັດສຳລັບການທົດສອບ

ຄຸນສົມບັດທົດສອບ
// ສັນຍາລັກທົດສອບແບບກຳນົດໄວ້
// ສັນຍາລັກທົດສອບທັງໝົດເລີ່ມຕົ້ນດ້ວຍ 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 ຄຳຮ້ອງຂໍ/ມື້, ບໍ່ຕ້ອງໃຊ້ບັດ) ແລະເລີ່ມດຶງຂໍ້ມູນ whale, ການສະໜັບສະໜູນ, ແລະ ຂໍ້ມູນ on-chain ຕົວຈິງ.

ຮັບກະແຈ 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 ປະກອບມີຄູ່ການຊື້ຂາຍທົດສອບເຫຼົ່ານີ້ທີ່ມີຂໍ້ມູນປະຫວັດສາດທີ່ເປັນຈິງ:

ສັນຍາລັກທົດສອບ
// ຄູ່ cryptocurrency
TEST_BTCUSDT, TEST_ETHUSDT, TEST_BNBUSDT
TEST_SOLSDT, TEST_ARBUSDT, TEST_OPUSDT
// ຄົ້ນຫາສັນຍາລັກທົດສອບ
GET /v1/symbols?test_only=true

ກະເປົາ Whale ທົດສອບ

ກະເປົາທົດສອບທີ່ກຳນົດໄວ້ລ່ວງໜ້າກັບພຶດຕິກຳທີ່ກຳນົດໄວ້:

  • ກະເປົາເກັບມ້ຽນ — ຊື້ເປັນປະຈຳ, ເໝາະສຳລັບການທົດສອບແບບເພີ່ມຂຶ້ນ
  • ກະເປົາຈຳໜ່າຍ — ຂາຍເປັນປະຈຳ, ເໝາະສຳລັບການທົດສອບແບບຫຼຸດລົງ
  • ກະເປົາແບບສະກັດກັ້ນ — ສະຫຼັບການຊື້/ຂາຍ, ເໝາະສຳລັບການທົດສອບແບບຄວາມປັນຜິດ
  • ກະເປົາແບບມີຄວາມຜັນຜວນ — ທຸລະກຳຂະໜາດໃຫຍ່ແບບສຸ່ມສຳລັບການທົດສອບຄວາມກົດດັນ

ການຣີເຊັດຂໍ້ມູນທົດສອບ

ຣີເຊັດຂໍ້ມູນທົດສອບ
// ຣີເຊັດບັນຊີທົດສອບທັງໝົດໃຫ້ກັບສະຖານະເດີມ
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 ຣີເຊັດຂໍ້ມູນທົດສອບໃຫ້ກັບສະຖານະເບື້ອງຕົ້ນ
POST /test/inject-error ເພີ່ມຂໍ້ຜິດພາດສະເພາະສຳລັບການທົດສອບ
POST /test/simulate-time ຈຳລອງສະຖານະການຕະຫຼາດທີ່ແຕກຕ່າງກັນ
GET /test/status ກວດສອບສະພາບສຸຂະພາບຂອງສະພາບແວດລ້ອມ sandbox

Response Mocking

Injecting Test Errors

ບັງຄັບໃຫ້ມີການຕອບວ່າມີຂໍ້ຜິດພາດສະເພາະສຳລັບການທົດສອບການຈັດການຂໍ້ຜິດພາດ:

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 Unauthorized ກັບກະແຈທົດສອບ

ວິທີແກ້ໄຂ:

  • ຢືນຢັນວ່າກະແຈເລີ່ມຕົ້ນດ້ວຍ sk_test_ (ບໍ່ແມ່ນ sk_live_)
  • ກວດສອບຮູບແບບຫົວຂໍ້ການອະນຸຍາດ: "Bearer sk_test_xxx"
  • ໃຫ້ແນ່ໃຈວ່າໃຊ້ endpoint ທົດສອບ: api-test.smartmoney.io
  • ກະແຈທົດສອບອາດຈະເກີນຈຳກັດອັດຕາສ່ວນ

ຂໍ້ມູນບໍ່ຣີເຊັດ

ບັນຫາ: ຂໍ້ມູນທົດສອບບໍ່ຣີເຊັດຫຼັງຈາກ POST /test/reset

ວິທີແກ້ໄຂ:

  • ການຣີເຊັດອາດຈະໃຊ້ເວລາເຖິງ 30 ວິນາທີເພື່ອແຜ່ກະຈາຍ
  • ກວດສອບສະຖານະ sandbox ດ້ວຍ GET /test/status
  • ຢືນຢັນວ່າໃຊ້ກະແຈ API ທົດສອບທີ່ຖືກຕ້ອງ
  • ຕິດຕໍ່ຝ່າຍຊ່ວຍເຫຼືອຖ້າຍັງມີບັນຫາຕໍ່ເນື່ອງ

ຈຳກັດອັດຕາສ່ວນໃນ Sandbox

ບັນຫາ: ກົດຈຳກັດອັດຕາສ່ວນໃນ sandbox (ບໍ່ຄວນເກີດຂຶ້ນ)

ວິທີແກ້ໄຂ:

  • ຢືນຢັນວ່າໃຊ້ sk_test_pro key (10,000/ຊົ່ວໂມງ)
  • ກວດສອບຫົວຂໍ້ X-RateLimit-Remaining
  • ລໍຖ້າຈົນຮອດເຂດເວລາຊົ່ວໂມງ ຫຼື ໃຊ້ບັນຊີທົດສອບອື່ນ
  • ຕິດຕໍ່ຝ່າຍຊ່ວຍເຫຼືອເພື່ອເພີ່ມຈຳກັດອັດຕາສ່ວນຊົ່ວຄາວ

ເລີ່ມທົດສອບມື້ນີ້

ໃຊ້ສະພາບແວດລ້ອມ sandbox ທີ່ຄົບຖ້ວນຂອງພວກເຮົາສຳລັບການພັດທະນາທີ່ປອດໄພ ແລະ ແຍກຕ່າງຫາກ. ຂໍ້ມູນທົດສອບທີ່ແນ່ນອນ, ຈຳກັດອັດຕາສ່ວນສູງ, ແລະ ຄຸນສົມບັດຄົບຖ້ວນຄືກັບ production.

ເອົາຂໍ້ມູນປະກາດທົດສອບ
ທຸກແຜນລວມມີການເຂົ້າເຖິງ sandbox. ບໍ່ມີຄ່າໃຊ້ຈ່າຍເພີ່ມເຕີມ.

ແຫຼ່ງຂໍ້ມູນທີ່ກ່ຽວຂ້ອງ

ຄູ່ມືການຢືນຢັນຕົວຕົນ →

ການຢືນຢັນຕົວຕົນ API ແລະ ການຈັດການກະແຈ

ຄູ່ມືອ້າງອີງ REST API →

ຯົບຖ້ວນເອກະສານ endpoint API

ລະຫັດຜິດພາດ →

ການຈັດການຜິດພາດ ແລະ ລະຫັດຕອບຮັບ
ເລີ່ມຟຣີ — 50 ຄຳຮ້ອງ/ມື້, ບໍ່ຕ້ອງໃຊ້ບັດ

ເອົາຂໍ້ມູນການໄຫຼຂອງ whale, ທຶນ, ດອກເບ້ຍທີ່ເປີດ ແລະ ຂໍ້ມູນ on-chain ຈາກ 3 ແລກປ່ຽນຈາກ API ດຽວ. ລະດັບຟຣີ, ບໍ່ຕ້ອງໃຊ້ບັດເຄຣດິດ, ອັບເກຣດໄດ້ທຸກເວລາ.

ເລີ່ມຟຣີ →
ລອງໃຊ້ຄອນໂຊນ API ຕົວຈິງ → (ບໍ່ຕ້ອງມີບັນຊີ)