API dokumentáció

API tesztelés és Sandbox környezet útmutató

Mesteri tesztelés a Smart Money API átfogó sandbox környezetével. Fejlessz kockázat nélkül valósághű tesztadatokkal, determinisztikus válaszokkal és bőkezű kérésszám-korlátokkal kísérletezéshez.

Közzétéve: 2026. március 21. • 14 perc olvasás • Fejlesztés

Sandbox környezet áttekintése

A Smart Money API egy teljes körű sandbox környezetet biztosít fejlesztéshez és teszteléshez. A sandbox a produkciós API szerkezetét tükrözi, de szintetikus adatokat és bőkezű kérésszám-korlátokat használ, így biztonságosan fejleszthet, mielőtt élesítene.

Kulcsjellemzők:

  • Megegyezik a produkcióval — Ugyanazok a végpontok, hitelesítés, válaszformátum
  • Csak tesztadatok — Sosem érinti a valós számlákat vagy piacokat
  • Magas kérésszám-korlát — 10 000 kérés/óra a produkciós 1 000 helyett
  • Determinisztikus válaszok — Konzisztens teszt adatok reprodukálható teszteléshez
  • Elkülönített számlák — Külön a produkciós felhasználói adatoktól

Ajánlott eljárás: Minden fejlesztés, tesztelés és előkészítés a sandbox környezetet használja. Csak a produkciót használja, miután alaposan tesztelte a sandboxban.

Sandbox jellemzők

Valósághű tesztadatok

A sandbox valósághű kriptovaluta piaci adatokat tartalmaz, amelyek nem változnak véletlenszerűen:

  • Történelmi piaci adatok (6 hónap valósághű OHLCV)
  • Rögzített bálnatárca-címek konzisztens mozgási mintákkal
  • Stabil finanszírozási ráta óránkénti visszaállással
  • Determinisztikus likvidációs minták szélsőséges esetek teszteléséhez

Teszt-specifikus jellemzők

Teszt funkciók
// Determinisztikus teszt szimbólumok
// Minden teszt szimbólum TEST_-el kezdődik
TEST_BTC, TEST_ETH, TEST_SOL stb.
// Varázs időbélyegek forgatókönyvek szimulálásához
GET /v1/derivatives/funding-heatmap?
timestamp=1234567890000 // Rögzített tesztadatokat ad vissza
// Hibák kényszerítése kivételkezelés teszteléséhez
X-Test-Error: rate_limit_exceeded
X-Test-Error: service_unavailable

Teszt segédeszközök

  • Adat visszaállítás — Minden teszt számla visszaállítása kezdeti állapotba
  • Idővezérlés — Különböző piaci feltételek szimulálása
  • Hiba befecskendezés — Konkrét hibaválaszok kényszerítése
  • Kérésszám-korlát tesztelés — Kérésszám-korlát válaszok kiváltása
API kulcs megszerzése 30 másodperc alatt

Készen áll a fejlesztésre? Szerezzen egy ingyenes API kulcsot (50 hívás/nap, kártya nélkül), és kezdjen élő bálnák, finanszírozási és láncon lévő adatok lekérését.

API kulcs lekérése →

Teszt hitelesítő adatok

Teszt API kulcsok beszerzése

Hozzon létre egy teszt fiókot az irányítópulton sandbox API kulcsok generálásához:

Teszt kulcs formátum
// A teszt kulcsok más előtaggal rendelkeznek
sk_test_1234567890abcdef // Teszt API kulcs
sk_live_1234567890abcdef // Produkciós API kulcs
// Automatikusan átirányítja a megfelelő környezetbe
GET https://api.smartmoneyapi.com/v1/whales
-H "Authorization: Bearer sk_test_xxx"
# Automatikusan a sandboxba irányít

Előre konfigurált teszt kulcsok

Használja ezeket a nyilvános teszt kulcsokat gyors kísérletezéshez (korlátozott kérésszám):

Kulcs Engedélyek Korlát
sk_test_demo Olvasás minden 100/óra
sk_test_trader Olvasás + figyelmeztetések 500/óra
sk_test_pro Teljes hozzáférés 5000/óra

Soha ne használjon teszt kulcsokat a produkcióban. Korlátozott funkcionalitásúak és kérésszám-korlátokkal rendelkeznek.

Teszt adatok és fixűrök

Elérhető teszt szimbólumok

A sandbox tartalmazza ezeket a teszt kereskedési párokat valósághű történelmi adatokkal:

Teszt szimbólumok
// Kriptovaluta párok
TEST_BTCUSDT, TEST_ETHUSDT, TEST_BNBUSDT
TEST_SOLSDT, TEST_ARBUSDT, TEST_OPUSDT
// Teszt szimbólumok lekérdezése
GET /v1/symbols?test_only=true

Teszt bálnatárcák

Előre konfigurált teszt tárcák determinisztikus viselkedéssel:

  • Akumulátor tárca — Folyamatos vásárlás, jó bullish teszteléshez
  • Disztribútor tárca — Folyamatos eladás, jó bearish teszteléshez
  • Oszcillátor tárca — Váltakozó vásárlás/eladás, jó range-bound teszteléshez
  • Volatilitás tárca — Véletlenszerű nagy tranzakciók stressz teszteléshez

Teszt adatok visszaállítása

Teszt adatok visszaállítása
// Minden teszt számla visszaállítása kezdeti állapotba
POST /v1/test/reset
-H "Authorization: Bearer sk_test_xxx"
// Konkrét erőforrás visszaállítása
POST /v1/test/reset?resource=whales
// Válasz
{
"status": "reset_complete",
"timestamp": 1709980800000
}

Sandbox végpontok

Alap URL-ek

Környezeti URL-ek
// Sandbox (teszt mód)
https://api-test.smartmoney.io/v1
// Vagy használj lekérdezési paramétert
https://api.smartmoneyapi.com/v1?environment=sandbox
// Éles (élő mód)
https://api.smartmoneyapi.com/v1

Csak Sandbox végpontok

Végpont Cél
POST /test/reset Tesztadatok visszaállítása kezdeti állapotba
POST /test/inject-error Adott hiba injektálása teszteléshez
POST /test/simulate-time Különböző piaci körülmények szimulálása
GET /test/status Sandbox környezet állapotának ellenőrzése

Válasz szimulálása

Teszt hibák injektálása

Adott hibaválaszok kényszerítése kivételkezelés teszteléséhez:

Hiba injektálás
// Díjlimit kezelés tesztelése
GET /v1/whales?X-Test-Error=rate_limit_exceeded
// Szolgáltatás elérhetetlenségének tesztelése
GET /v1/whales?X-Test-Error=service_unavailable
// Hitelesítési hiba tesztelése
GET /v1/whales?X-Test-Error=invalid_key
// Időtúllépés tesztelése
GET /v1/whales?X-Test-Error=timeout

Elérhető teszt hibák

Hibakód HTTP státusz Használati eset
invalid_key 401 Hitelesítési hiba kezelése
rate_limit_exceeded 429 Visszalépési logika tesztelése
not_found 404 Hiányzó erőforrás kezelése
service_unavailable 503 Újrapróbálkozási logika tesztelése
timeout 504 Időtúllépés kezelése

Sandbox díjlimit

Díjlimit szintek

Környezet Limit/óra Burst Cél
Sandbox 10,000 500/perc Fejlesztés és tesztelés
Éles Ingyenes 1,000 50/perc Hobbi projektek
Éles Kereskedő 10,000 400/perc Professzionális kereskedés
Éles Pro 50,000 1000/perc Magas frekvenciájú rendszerek

Díjlimit kezelés tesztelése

Díjlimit tesztelés
// Díjlimit válasz kiváltása sandboxban
curl -H "X-Test-Error: rate_limit_exceeded" \
https://api-test.smartmoney.io/v1/whales
// A válasz tartalmazza az újrapróbálkozási fejléceket
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709984400
Retry-After: 3600

Tesztelési stratégiák

Egységtesztelés fixstúrákkal

Python Egységteszt
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())

Integrációs tesztelés

Teljes munkafolyamat tesztelése sandboxban éles bevezetés előtt:

  1. Telepítés átmeneti környezetbe sandbox hitelesítő adatokkal
  2. Teljes tesztcsomag futtatása sandbox ellen
  3. Hibakezelés tesztelése hibainjektálással
  4. Díjlimit viselkedés ellenőrzése
  5. Válaszidő és késleltetés ellenőrzése
  6. Csak ezután léptetés élesbe

Terhelés tesztelés

Terhelés tesztelés Apache Bench-el
// Sandbox lehetővé teszi a magas terhelésű tesztelést
ab -n 5000 -c 100 \
-H "Authorization: Bearer sk_test_pro" \
https://api-test.smartmoney.io/v1/whales/TEST_BTC

CI/CD integráció

GitHub Actions példa

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

Környezeti konfiguráció

Használj környezeti változókat a sandbox és a termelési környezet közötti váltáshoz:

Környezet beállítása
// .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

Hibaelhárítás

Gyakori problémák

Tesztkulcs nem működik

Probléma: 401 Unauthorized hiba a tesztkulccsal

Megoldások:

  • Ellenőrizd, hogy a kulcs sk_test_-tel kezdődik (ne sk_live_)
  • Ellenőrizd az Authorization fejléc formátumát: "Bearer sk_test_xxx"
  • Győződj meg róla, hogy a teszt végpontot használod: api-test.smartmoney.io
  • A tesztkulcs elérhette a ráta limitet

Adatok nem állnak vissza

Probléma: A tesztadatok nem állnak vissza a POST /test/reset után

Megoldások:

  • A visszaállítás akár 30 másodpercet is igénybe vehet
  • Ellenőrizd a sandbox állapotát a GET /test/status segítségével
  • Győződj meg róla, hogy a helyes teszt API kulcsot használod
  • Lépj kapcsolatba az ügyfélszolgálattal, ha a probléma fennáll

Ráta limit a sandboxban

Probléma: Ráta limitet érsz el a sandboxban (nem szabadna)

Megoldások:

  • Ellenőrizd, hogy sk_test_pro kulcsot használsz-e (10,000/óra)
  • Ellenőrizd az X-RateLimit-Remaining fejlécet
  • Várj az óra határára vagy használj másik teszt fiókot
  • Lépj kapcsolatba az ügyfélszolgálattal ideiglenes ráta limit növelésért

Kezdj el tesztelni ma

Használd átfogó sandbox környezetünket a biztonságos, izolált fejlesztéshez. Determinisztikus tesztadatok, magas ráta limit és teljes funkcionalitás a termelési környezettel.

Szerezd meg a teszt hitelesítő adatokat
Minden csomag tartalmaz sandbox hozzáférést. Nincs további költség.

Kapcsolódó források

Hitelesítési útmutató →

API hitelesítés és kulcskezelés

REST API referencia →

Teljes API végpont dokumentáció

Hibakódok →

Hibakezelés és válaszkódok
Kezdd ingyen — 50 hívás/nap, kártya nélkül

Szerezd élő whale flow, finanszírozási, nyílt kamat és on-chain adatokat 3 tőzsdéről egy API-ból. Ingyenes szint, nincs bankkártya kötelező, bármikor frissíthetsz.

Kezdd ingyen →
Próbáld ki az élő API konzolt → (nincs fiók szükséges)