API டாக்யூமென்டேஷன்

API டெஸ்டிங் மற்றும் சாண்ட்பாக்ஸ் சூழல் வழிகாட்டி

ஸ்மார்ட் மனி API இன் விரிவான சாண்ட்பாக்ஸ் சூழலைப் பயன்படுத்தி டெஸ்டிங் மாஸ்டர் செய்யுங்கள். ரியலிஸ்டிக் டெஸ்ட் டேட்டா, டிடர்மினிஸ்டிக் ரெஸ்பான்ஸ்கள் மற்றும் பரிசோதனைக்கு ஜெனரஸ் ரேட் லிமிட்ஸ் ஆகியவற்றைப் பயன்படுத்தி ஆபத்து இல்லாமல் உருவாக்குங்கள்.

பப்ளிஷ்ட் மார்ச் 21, 2026 • 14 நிமிடம் படிக்க • டெவலப்மென்ட்

சாண்ட்பாக்ஸ் சூழல் கண்ணோட்டம்

ஸ்மார்ட் மனி API டெவலப்மென்ட் மற்றும் டெஸ்டிங் க்கு ஒரு புல்-பீச்சர்ட் சாண்ட்பாக்ஸ் சூழலை வழங்குகிறது. சாண்ட்பாக்ஸ் ப்ராடக்ஷன் API ஸ்ட்ரக்சரை மிரர் செய்கிறது ஆனால் சிந்தெடிக் டேட்டா மற்றும் ஜெனரஸ் ரேட் லிமிட்ஸ் பயன்படுத்துகிறது, இது லைவ் செல்லும் முன் நீங்கள் நம்பிக்கையுடன் உருவாக்க உதவுகிறது.

முக்கிய பண்புகள்:

  • ப்ராடக்ஷனுக்கு ஒத்தது — அதே எண்ட்பாயிண்ட்ஸ், ஆதென்டிகேஷன், ரெஸ்பான்ஸ் ஃபார்மேட்
  • டெஸ்ட் டேட்டா மட்டும் — உண்மையான கணக்குகள் அல்லது லைவ் மார்க்கெட்டுகளை பாதிக்காது
  • உயர் ரேட் லிமிட்ஸ் — 10,000 கோரிக்கைகள்/மணி vs 1,000 ப்ராடக்ஷனில்
  • டிடர்மினிஸ்டிக் ரெஸ்பான்ஸ்கள் — ரிப்ப்ரோட்யூஸிபிள் டெஸ்டிங் க்கு சீரான டெஸ்ட் ஃபிக்சர்ஸ்
  • ஐசோலேட்டட் கணக்குகள் — ப்ராடக்ஷன் யூசர் டேட்டாவிலிருந்து தனி

சிறந்த நடைமுறை: அனைத்து டெவலப்மென்ட், டெஸ்டிங் மற்றும் ஸ்டேஜிங் சாண்ட்பாக்ஸ் சூழலைப் பயன்படுத்த வேண்டும். முழுமையான சாண்ட்பாக்ஸ் வாலிடேஷன் பிறகு மட்டுமே ப்ராடக்ஷன் பயன்படுத்தவும்.

சாண்ட்பாக்ஸ் அம்சங்கள்

ரியலிஸ்டிக் டெஸ்ட் டேட்டா

சாண்ட்பாக்ஸ் ரியலிஸ்டிக் கிரிப்டோகரன்சி மார்க்கெட் டேட்டாவைக் கொண்டுள்ளது, இது ரேண்டமாக மாறாது:

  • ஹிஸ்டாரிகல் மார்க்கெட் டேட்டா (6 மாதங்கள் ரியலிஸ்டிக் OHLCV)
  • ஃபிக்ஸ்ட் வேல் வாலெட் அட்ரஸ்ஸ்கள் சீரான மூவ்மென்ட் பேட்டர்ன்ஸ் உடன்
  • ஸ்டேபிள் ஃபண்டிங் ரேட்ஸ் ஹவர்லி ரீசெட் செய்யும்
  • டிடர்மினிஸ்டிக் லிக்விடேஷன் பேட்டர்ன்ஸ் எட்ஜ் கேஸ்கள் டெஸ்டிங் க்கு

டெஸ்ட்-ஸ்பெசிஃபிக் அம்சங்கள்

டெஸ்ட் அம்சங்கள்
// டிடர்மினிஸ்டிக் டெஸ்ட் சிம்பல்ஸ்
// அனைத்து டெஸ்ட் சிம்பல்ஸ் TEST_ உடன் தொடங்கும்
TEST_BTC, TEST_ETH, TEST_SOL, etc.
// மேஜிக் டைம்ஸ்டாம்ப்ஸ் சிமுலேடிங் சினாரியோக்கள் க்கு
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 கீகளை ஜெனரேட் செய்யுங்கள்:

டெஸ்ட் கீ ஃபார்மேட்
// டெஸ்ட் கீகள் வெவ்வேறு ப்ரீஃபிக்ஸ் கொண்டவை
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 Too Many Requests
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 Actions எடுத்துக்காட்டு

.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/

சூழல் கட்டமைப்பு

சாண்ட்பாக்ஸ் மற்றும் ப்ரொடக்ஷன் இடையே மாற்றுவதற்கு சூழல் மாறிகள் பயன்படுத்தவும்:

சூழல் அமைப்பு
// .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 கன்சோல் முயற்சிக்கவும் → (கணக்கு தேவையில்லை)