Dokumentace API

Průvodce testováním API a sandboxovým prostředím

Ovládněte testování s komplexním sandboxovým prostředím Smart Money API. Vyvíjejte bez rizika pomocí realistických testovacích dat, deterministických odpovědí a velkorysých limitů pro experimentování.

Publikováno 21. března 2026 • 14 minut čtení • Vývoj

Přehled sandboxového prostředí

Smart Money API poskytuje plnohodnotné sandboxové prostředí pro vývoj a testování. Sandbox kopíruje strukturu produkčního API, ale využívá syntetická data a velkorysé limity počtu požadavků, což vám umožňuje vyvíjet s jistotou před nasazením do provozu.

Klíčové charakteristiky:

  • Identické s produkčním prostředím — Stejné endpointy, autentizace, formát odpovědí
  • Pouze testovací data — Nikdy neovlivní reálné účty nebo živé trhy
  • Vysoké limity počtu požadavků — 10 000 požadavků/hodinu oproti 1 000 v produkci
  • Deterministické odpovědi — Konzistentní testovací data pro reprodukovatelné testování
  • Izolované účty — Oddělené od produkčních uživatelských dat

Doporučený postup: Veškerý vývoj, testování a staging by měl využívat sandboxové prostředí. Produkční prostředí používejte až po důkladném ověření v sandboxu.

Funkce sandboxu

Realistická testovací data

Sandbox obsahuje realistická data kryptoměnových trhů, která se nemění náhodně:

  • Historická tržní data (6 měsíců realistických OHLCV)
  • Pevné adresy velrybích peněženek s konzistentními pohyby
  • Stabilní funding rates resetované každou hodinu
  • Deterministické vzorce likvidací pro testování hraničních případů

Funkce specifické pro testování

Testovací funkce
// Deterministické testovací symboly
// Všechny testovací symboly začínají TEST_
TEST_BTC, TEST_ETH, TEST_SOL, atd.
// Magické časové značky pro simulaci scénářů
GET /v1/derivatives/funding-heatmap?
timestamp=1234567890000 // Vrátí pevná testovací data
// Vynucení chyb pro testování zpracování výjimek
X-Test-Error: rate_limit_exceeded
X-Test-Error: service_unavailable

Testovací utility

  • Reset dat — Obnoví všechny testovací účty do výchozího stavu
  • Řízení času — Simulace různých tržních podmínek
  • Vkládání chyb — Vynucení specifických chybových odpovědí
  • Testování limitů počtu požadavků — Spuštění odpovědí na překročení limitu
Získejte svůj API klíč za 30 sekund

Připraveni začít? Získejte zdarma API klíč (200 volání/den, bez karty) a začněte stahovat data o velrybách, financování a on-chain transakcích.

Získejte svůj API klíč →

Testovací přihlašovací údaje

Získání testovacích API klíčů

Vytvořte si testovací účet přes dashboard pro generování sandboxových API klíčů:

Formát testovacího klíče
// Testovací klíče mají jinou předponu
sk_test_1234567890abcdef // Testovací API klíč
sk_live_1234567890abcdef // Produkční API klíč
// Automaticky směruje do příslušného prostředí
GET https://api.smartmoneyapi.com/v1/whales
-H "Authorization: Bearer sk_test_xxx"
# Automaticky směruje do sandboxu

Přednastavené testovací klíče

Pro rychlé experimentování použijte tyto veřejné testovací klíče (s omezením počtu požadavků):

Klíč Oprávnění Limit
sk_test_demo Čtení všech dat 100/hodinu
sk_test_trader Čtení + upozornění 500/hodinu
sk_test_pro Úplný přístup 5000/hodinu

Nikdy nepoužívejte testovací klíče v produkčním prostředí. Mají omezenou funkčnost a limity počtu požadavků.

Testovací data a fixture

Dostupné testovací symboly

Sandbox obsahuje tyto testovací obchodní páry s realistickými historickými daty:

Testovací symboly
// Kryptoměnové páry
TEST_BTCUSDT, TEST_ETHUSDT, TEST_BNBUSDT
TEST_SOLSDT, TEST_ARBUSDT, TEST_OPUSDT
// Dotaz na testovací symboly
GET /v1/symbols?test_only=true

Testovací velrybí peněženky

Přednastavené testovací peněženky s deterministickým chováním:

  • Akumulační peněženka — Konzistentně nakupuje, vhodné pro býčí testování
  • Distribuční peněženka — Konzistentně prodává, vhodné pro medvědí testování
  • Oscilační peněženka — Střídá nákupy a prodeje, vhodné pro testování v rozmezí
  • Peněženka volatility — Náhodné velké transakce pro stresové testování

Resetování testovacích dat

Reset testovacích dat
// Obnoví všechny testovací účty do výchozího stavu
POST /v1/test/reset
-H "Authorization: Bearer sk_test_xxx"
// Reset konkrétního zdroje
POST /v1/test/reset?resource=whales
// Odpověď
{
"status": "reset_complete",
"timestamp": 1709980800000
}

Sandbox Endpointy

Základní URL

URL prostředí
// Sandbox (testovací režim)
https://api-test.smartmoney.io/v1
// Nebo použijte parametr dotazu
https://api.smartmoneyapi.com/v1?environment=sandbox
// Produkce (live režim)
https://api.smartmoneyapi.com/v1

Endpointy pouze pro Sandbox

Endpoint Účel
POST /test/reset Reset testovacích dat do počátečního stavu
POST /test/inject-error Vložení specifické chyby pro testování
POST /test/simulate-time Simulace různých tržních podmínek
GET /test/status Kontrola stavu sandbox prostředí

Mockování odpovědí

Vkládání testovacích chyb

Vynucení specifických chybových odpovědí pro testování zpracování výjimek:

Vložení chyby
// Testování zpracování limitu frekvence
GET /v1/whales?X-Test-Error=rate_limit_exceeded
// Testování nedostupnosti služby
GET /v1/whales?X-Test-Error=service_unavailable
// Testování selhání autentizace
GET /v1/whales?X-Test-Error=invalid_key
// Testování časového limitu
GET /v1/whales?X-Test-Error=timeout

Dostupné testovací chyby

Kód chyby HTTP Status Použití
invalid_key 401 Zpracování chyby autentizace
rate_limit_exceeded 429 Testování logiky backoff
not_found 404 Zpracování chybějícího zdroje
service_unavailable 503 Testování logiky opakování
timeout 504 Zpracování časového limitu

Limity frekvence v Sandboxu

Úrovně limitu frekvence

Prostředí Limit/hod Burst Účel
Sandbox 10,000 500/min Vývoj & testování
Production Free 1,000 50/min Hobby projekty
Production Trader 10,000 400/min Profesionální obchodování
Production Pro 50,000 1000/min Vysokofrekvenční systémy

Testování zpracování limitu frekvence

Testování limitu frekvence
// Spuštění odpovědi limitu frekvence v sandboxu
curl -H "X-Test-Error: rate_limit_exceeded" \
https://api-test.smartmoney.io/v1/whales
// Odpověď obsahuje hlavičky pro opakování
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709984400
Retry-After: 3600

Testovací strategie

Unit testování s fixturemi

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())

Integrační testování

Otestujte celý pracovní postup v sandboxu před nasazením do produkce:

  1. Nasaďte do stagingu s sandbox přihlašovacími údaji
  2. Spusťte kompletní testovací sadu proti sandboxu
  3. Otestujte zpracování chyb pomocí vkládání chyb
  4. Ověřte chování limitu frekvence
  5. Zkontrolujte dobu odezvy a latenci
  6. Teprve potom převeďte do produkce

Zátěžové testování

Zátěžový test s Apache Bench
// Sandbox umožňuje zátěžové testování
ab -n 5000 -c 100 \
-H "Authorization: Bearer sk_test_pro" \
https://api-test.smartmoney.io/v1/whales/TEST_BTC

CI/CD Integrace

Příklad 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/

Konfigurace prostředí

Použijte proměnné prostředí pro přepínání mezi sandboxem a produkčním prostředím:

Nastavení prostředí
// .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

Řešení problémů

Běžné problémy

Testovací klíč nefunguje

Problém: Získáváte 401 Neautorizováno s testovacím klíčem

Řešení:

  • Ověřte, že klíč začíná na sk_test_ (ne sk_live_)
  • Zkontrolujte formát hlavičky Authorization: "Bearer sk_test_xxx"
  • Ujistěte se, že používáte testovací endpoint: api-test.smartmoney.io
  • Testovací klíč mohl překročit limit počtu požadavků

Data se neresetují

Problém: Testovací data se neresetují po POST /test/reset

Řešení:

  • Reset může trvat až 30 sekund, než se projeví
  • Zkontrolujte stav sandboxu pomocí GET /test/status
  • Ověřte, že používáte správný testovací API klíč
  • Kontaktujte podporu, pokud problém přetrvává

Limity počtu požadavků v sandboxu

Problém: Dosahujete limitů počtu požadavků v sandboxu (nemělo by se stát)

Řešení:

  • Ověřte, že používáte klíč sk_test_pro (10 000/hodinu)
  • Zkontrolujte hlavičku X-RateLimit-Remaining
  • Počkejte na hodinovou hranici nebo použijte jiný testovací účet
  • Kontaktujte podporu pro dočasné zvýšení limitu počtu požadavků

Začněte testovat ještě dnes

Použijte náš komplexní sandbox pro bezpečný a izolovaný vývoj. Deterministická testovací data, vysoké limity počtu požadavků a plná kompatibilita funkcí s produkčním prostředím.

Získejte testovací přihlašovací údaje
Všechny plány zahrnují přístup do sandboxu. Bez dalších nákladů.

Související zdroje

Průvodce autentizací →

Autentizace API a správa klíčů

Reference REST API →

Kompletní dokumentace API endpointů

Chybové kódy →

Zpracování chyb a kódy odpovědí
Začněte zdarma — 200 volání/den, bez karty

Získejte živá data o toku velryb, financování, otevřeném zájmu a on-chain datech napříč 3 burzami z jednoho API. Volná úroveň, bez kreditní karty, upgrade kdykoli.

Začněte zdarma →
Vyzkoušejte živou API konzoli → (účet není potřeba)