API ලේඛනගත කිරීම

API පරීක්ෂණ සහ සැන්ඩ්බොක් පරිසර මාර්ගෝපදේශය

Smart Money API හි සවිස්තරාත්මක සැන්ඩ්බොක් පරිසරය සමඟ පරීක්ෂණයේ දක්ෂතාවය ලබා ගන්න. යථාර්ථවාදී පරීක්ෂණ දත්ත, නිශ්චිත ප්‍රතිචාර සහ පරීක්ෂණ සඳහා ජනරාල් අනුපාත සීමා භාවිතා කරමින් අවදානම් නොමැතිව සංවර්ධනය කරන්න.

පළ කළ දිනය මාර්තු 21, 2026 • විනාඩි 14 ක කියවීම • සංවර්ධනය

සැන්ඩ්බොක් පරිසර දළ විශ්ලේෂණය

Smart Money API සංවර්ධනය සහ පරීක්ෂණ සඳහා සම්පූර්ණ විශේෂාංග සහිත සැන්ඩ්බොක් පරිසරයක් සපයයි. සැන්ඩ්බොක් නිෂ්පාදන API ව්‍යුහය පිළිබිඹු කරයි, නමුත් සින්තටික් දත්ත සහ ජනරාල් අනුපාත සීමා භාවිතා කරයි, එමඟින් ඔබට සජීවීවීමට පෙර විශ්වාසයෙන් සංවර්ධනය කිරීමට ඉඩ සලසයි.

ප්‍රධාන ලක්ෂණ:

  • නිෂ්පාදනයට සමානයි — එකම අන්ත ලක්ෂ්‍ය, සත්‍යාපනය, ප්‍රතිචාර ආකෘතිය
  • පරීක්ෂණ දත්ත පමණි — සැබෑ ගිණුම් හෝ සජීවී වෙළඳපොලවල් බලපාන්නේ නැත
  • ඉහළ අනුපාත සීමා — පැයකට ඉල්ලීම් 10,000 ක්, නිෂ්පාදනයේ 1,000 ට වඩා
  • නිශ්චිත ප්‍රතිචාර — පුනරාවර්තන පරීක්ෂණ සඳහා ස්ථාවර පරීක්ෂණ උපකරණ
  • වෙන් කළ ගිණුම් — නිෂ්පාදන පරිශීලක දත්ත වලින් වෙන් කර ඇත

හොඳම පරිචය: සියලුම සංවර්ධන, පරීක්ෂණ සහ අදියර සැන්ඩ්බොක් පරිසරය භාවිතා කළ යුතුය. සැන්ඩ්බොක් සත්‍යාපනය සම්පූර්ණයෙන් සිදු කිරීමෙන් පසුව පමණක් නිෂ්පාදනය භාවිතා කරන්න.

සැන්ඩ්බොක් විශේෂාංග

යථාර්ථවාදී පරීක්ෂණ දත්ත

සැන්ඩ්බොක් හි අහඹු ලෙස වෙනස් නොවන යථාර්ථවාදී ගුප්තව්යවහාරික වෙළඳපොල දත්ත අඩංගු වේ:

  • ඓතිහාසික වෙළඳපොල දත්ත (යථාර්ථවාදී OHLCV මාස 6 ක්)
  • ස්ථාවර තල්ලා රැකියා ලිපින ස්ථාවර චලන රටා සමඟ
  • පැයකට එක් වරක් යළි සකසන ස්ථාවර අරමුදල් අනුපාත
  • දාර අවස්ථා පරීක්ෂා කිරීම සඳහා නිශ්චිත ද්‍රව්‍යකරණ රටා

පරීක්ෂණ-විශේෂිත විශේෂාංග

පරීක්ෂණ විශේෂාංග
// නිශ්චිත පරීක්ෂණ සංකේත
// සියලුම පරීක්ෂණ සංකේත 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

පරීක්ෂණ උපකරණ

  • දත්ත යළි සකසන්න — සියලුම පරීක්ෂණ ගිණුම් ආරම්භක තත්ත්වයට යළි සකසන්න
  • කාල පාලනය — විවිධ වෙළඳපොල තත්ත්ව අනුකරණය කරන්න
  • දෝෂ ඇතුළු කිරීම — නිශ්චිත දෝෂ ප්‍රතිචාර බලකරයි
  • අනුපාත සීමා පරීක්ෂණය — අනුපාත සීමා ප්‍රතිචාර අවුලුවන්න
තත්පර 30 කින් ඔබගේ API යතුර ලබා ගන්න

නිර්මාණයට සූදානම්ද? නොමිලේ API යතුරක් ගන්න (දිනකට ඇමතුම් 50 ක්, කාඩ්පතක් නැත) සහ සජීවී තල්ලා, අරමුදල් සහ චේන් දත්ත ඇද ගැනීම ආරම්භ කරන්න.

ඔබගේ API යතුර ලබා ගන්න →

පරීක්ෂණ අක්තපත්‍ර

පරීක්ෂණ API යතුරු ලබා ගැනීම

සැන්ඩ්බොක් API යතුරු ජනනය කිරීම සඳහා ඩෑෂ්බෝඩ් හරහා පරීක්ෂණ ගිණුමක් සාදන්න:

පරීක්ෂණ යතුරු ආකෘතිය
// පරීක්ෂණ යතුරු වල වෙනස් උපසර්ගයක් ඇත
sk_test_1234567890abcdef // පරීක්ෂණ API යතුර
sk_live_1234567890abcdef // නිෂ්පාදන API යතුර
// ස්වයංක්‍රීයව ගැලපෙන පරිසරයට යොමු කරයි
GET https://api.smartmoneyapi.com/v1/whales
-H "Authorization: Bearer sk_test_xxx"
# ස්වයංක්‍රීයව සැන්ඩ්බොක් වෙත යොමු කරයි

පූර්ව-වින්‍යාසගත පරීක්ෂණ යතුරු

ක්ෂණික අත්හදා බැලීම් සඳහා මෙම පොදු පරීක්ෂණ යතුරු භාවිතා කරන්න (අනුපාත සීමා කර ඇත):

යතුර අවසර සීමාව
sk_test_demo සියල්ල කියවන්න පැයකට 100
sk_test_trader කියවන්න + ඇඟවීම් පැයකට 500
sk_test_pro සම්පූර්ණ ප්‍රවේශය පැයකට 5000

නිෂ්පාදනයේ පරීක්ෂණ යතුරු භාවිතා නොකරන්න. ඒවාට සීමිත ක්‍රියාකාරිත්වය සහ අනුපාත සීමා ඇත.

පරීක්ෂණ දත්ත සහ උපකරණ

ලබා ගත හැකි පරීක්ෂණ සංකේත

සැන්ඩ්බොක් හි යථාර්ථවාදී ඓතිහාසික දත්ත සහිත මෙම පරීක්ෂණ වෙළඳ යුගල ඇතුළත් වේ:

පරීක්ෂණ සංකේත
// ගුප්තව්යවහාරික යුගල
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
}

සැන්ඩ්බොක්ස් අන්ත ලක්ෂ්‍ය

පාදක URL

පරිසර URL
// සැන්ඩ්බොක්ස් (පරීක්ෂණ ප්‍රකාරය)
https://api-test.smartmoney.io/v1
// හෝ විමසුම් පරාමිතිය භාවිතා කරන්න
https://api.smartmoneyapi.com/v1?environment=sandbox
// නිෂ්පාදන (සජීවී ප්‍රකාරය)
https://api.smartmoneyapi.com/v1

සැන්ඩ්බොක්ස් පමණක් අන්ත ලක්ෂ්‍ය

අන්ත ලක්ෂ්‍ය අරමුණ
POST /test/reset පරීක්ෂණ දත්ත ආරම්භක තත්ත්වයට යළි සකසන්න
POST /test/inject-error පරීක්ෂණ සඳහා විශේෂිත දෝෂය ඇතුළු කරන්න
POST /test/simulate-time විවිට වෙළඳපොල තත්ත්ව අනුහුරු කරන්න
GET /test/status සැන්ඩ්බොක්ස් පරිසර සෞඛ්‍යය පරීක්ෂා කරන්න

ප්‍රතිචාර අනුහුරු කිරීම

පරීක්ෂණ දෝෂ ඇතුළු කිරීම

ව්‍යතිරේක හැසිරවීමේ පරීක්ෂණ සඳහා විශේෂිත දෝෂ ප්‍රතිචාර බලහත්කාරයෙන් ඇතුළු කරන්න:

දෝෂ ඇතුළු කිරීම
// අනුපාත සීමාව හැසිරවීම පරීක්ෂා කරන්න
GET /v1/whales?X-Test-Error=rate_limit_exceeded
// සේවය ලබා ගත නොහැකි බව පරීක්ෂා කරන්න
GET /v1/whales?X-Test-Error=service_unavailable
// සත්‍යාපන අසමත්වීම පරීක්ෂා කරන්න
GET /v1/whales?X-Test-Error=invalid_key
// කාලය ඉක්මවා යාම පරීක්ෂා කරන්න
GET /v1/whales?X-Test-Error=timeout

ලබා ගත හැකි පරීක්ෂණ දෝෂ

දෝෂ කේතය HTTP තත්ත්වය භාවිත අවස්ථාව
invalid_key 401 සත්‍යාපන දෝෂ හැසිරවීම
rate_limit_exceeded 429 පසුබෑම් තර්කන පරීක්ෂණය
not_found 404 නැතිවූ සම්පත් හැසිරවීම
service_unavailable 503 යළි උත්සාහ තර්කන පරීක්ෂණය
timeout 504 කාලය ඉක්මවා යාම හැසිරවීම

සැන්ඩ්බොක්ස් අනුපාත සීමා

අනුපාත සීමා තරඟ

පරිසරය සීමාව/පැය පිපිරීම අරමුණ
සැන්ඩ්බොක්ස් 10,000 500/මිනි සංවර්ධනය සහ පරීක්ෂණය
නිෂ්පාදන නිදහස් 1,000 50/මිනි විනෝදාංශ ව්‍යාපෘති
නිෂ්පාදන වෙළෙන්දා 10,000 400/මිනි වෘත්තීය වෙළඳාම
නිෂ්පාදන ප්‍රෝ 50,000 1000/මිනි ඉහළ-සංඛ්‍යාත පද්ධති

අනුපාත සීමා හැසිරවීම පරීක්ෂා කිරීම

අනුපාත සීමා පරීක්ෂණය
// සැන්ඩ්බොක්ස් හි අනුපාත සීමා ප්‍රතිචාරය අවුලුවන්න
curl -H "X-Test-Error: rate_limit_exceeded" \
https://api-test.smartmoney.io/v1/whales
// ප්‍රතිචාරය යළි උත්සාහ ශීර්ෂ ඇතුළත් කරයි
HTTP/1.1 429 බොහෝ ඉල්ලීම්
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709984400
Retry-After: 3600

පරීක්ෂණ උපාය මාර්ග

උපාංග සමඟ ඒකක පරීක්ෂණ

පයිතන් ඒකක පරීක්ෂණය
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())

සම්බන්ධතා පරීක්ෂණය

නිෂ්පාදන යෙදවුමට පෙර සැන්ඩ්බොක්ස් හි සම්පූර්ණ ක්‍රියාවලිය පරීක්ෂා කරන්න:

  1. සැන්ඩ්බොක්ස් අක්තපත්‍ර සමඟ අදියරට ප්‍රකාශනය කරන්න
  2. සැන්ඩ්බොක්ස් එක්ක සම්පූර්ණ පරීක්ෂණ සුට් ධාවනය කරන්න
  3. දෝෂ ඇතුළු කිරීම සමඟ දෝෂ හැසිරවීම පරීක්ෂා කරන්න
  4. අනුපාත සීමා හැසිරවීම සත්‍යාපනය කරන්න
  5. ප්‍රතිචාර කාලය සහ ප්‍රමාදය පරීක්ෂා කරන්න
  6. එතකොට පමණක් නිෂ්පාදනයට ප්‍රවර්ධනය කරන්න

බර පරීක්ෂණය

ඇපච් බෙන්ච් සමඟ බර පරීක්ෂණය
// සැන්ඩ්බොක්ස් ඉහළ බර පරීක්ෂණ ඉඩ දෙයි
ab -n 5000 -c 100 \
-H "Authorization: Bearer sk_test_pro" \
https://api-test.smartmoney.io/v1/whales/TEST_BTC

CI/CD ඒකාබද්ධ කිරීම

GitHub ක්‍රියා උදාහරණය

.github/workflows/test.yml
name: API පරීක්ෂණ
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/

පරිසර වින්‍යාසය

සැන්ඩ්බොක්ස් සහ ප්‍රෝඩක්ෂන් අතර මාරුවීමට පරිසර විචල්‍යයන් භාවිතා කරන්න:

පරිසර සැකසුම
// .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 ක් දක්වා ගත විය හැකිය
  • GET /test/status සමඟ සැන්ඩ්බොක්ස් තත්ත්වය පරීක්ෂා කරන්න
  • නිවැරදි පරීක්ෂණ API යතුර භාවිතා කරන බව සත්‍යාපනය කරන්න
  • නිතර ගැටලු වුවහොත් සහාය අමතන්න

සැන්ඩ්බොක්ස්හි අනුපාත සීමා

ගැටලුව: සැන්ඩ්බොක්ස්හි අනුපාත සීමාවන්ට පහර දීම (සිදු නොවිය යුතුය)

විසඳුම්:

  • sk_test_pro යතුර භාවිතා කරන බව සත්‍යාපනය කරන්න (පැයට 10,000)
  • X-RateLimit-Remaining ශීර්ෂය පරීක්ෂා කරන්න
  • පැය සීමාව බලා සිටින්න හෝ වෙනස් පරීක්ෂණ ගිණුමක් භාවිතා කරන්න
  • තාවකාලික අනුපාත සීමාව වැඩි කිරීම සඳහා සහාය අමතන්න

අදම පරීක්ෂණය ආරම්භ කරන්න

ආරක්ෂිත, හුදකලා සංවර්ධනය සඳහා අපගේ සම්පූර්ණ සැන්ඩ්බොක්ස් පරිසරය භාවිතා කරන්න. නිශ්චිත පරීක්ෂණ දත්ත, ඉහළ අනුපාත සීමා, සහ නිෂ්පාදනය සමඟ සම්පූර්ණ විශේෂාංග සමානතාව.

පරීක්ෂණ අක්තපත්‍ර ලබා ගන්න
සියලුම සැලසුම්වල සැන්ඩ්බොක්ස් ප්‍රවේශය ඇතුළත් වේ. අතිරේක පිරිවැයක් නැත.

අදාළ සම්පත්

සත්‍යාපන මාර්ගෝපදේශය →

API සත්‍යාපනය සහ යතුර කළමනාකරණය

REST API යොමුව →

සම්පූර්ණ API අන්ත ලක්ෂ්‍ය ලියකියවිලි

දෝෂ කේත →

දෝෂ හැසිරවීම සහ ප්‍රතිචාර කේත
නොමිලේ ආරම්භ කරන්න — දිනකට ඇමතුම් 50, කාඩ්පතක් අවශ්‍ය නැත

එක් API එකකින් ජීවමාන තල්ලු ප්‍රවාහය, අරමුදල්, විවෘත උනන්දුව සහ චේන් දත්ත 3 විනිමය අතර ලබා ගන්න. නොමිලේ තල, ක්‍රෙඩිට් කාඩ්පතක් අවශ්‍ය නැත, ඕනෑම වේලාවක උත්ශ්‍රේණි කරන්න.

නොමිලේ ආරම්භ කරන්න →
සජීවී API කොන්සෝලය උත්සාහ කරන්න → (ගිණුමක් අවශ්‍ය නැත)