API Dokümantasyonu

API Test ve Sandbox Ortamı Rehberi

Smart Money API'nin kapsamlı sandbox ortamıyla test becerilerinizi geliştirin. Gerçekçi test verileri, deterministik yanıtlar ve bol miktarda oran limitiyle risksiz bir şekilde geliştirin.

21 Mart 2026 tarihinde yayınlandı • 14 dakikalık okuma • Geliştirme

Sandbox Ortamına Genel Bakış

Smart Money API, geliştirme ve test için tam özellikli bir sandbox ortamı sunar. Sandbox, üretim API yapısını yansıtır ancak sentetik veriler ve bol miktarda oran limiti kullanır, böylece canlıya almadan önce güvenle geliştirme yapabilirsiniz.

Temel özellikler:

  • Üretimle Aynı — Aynı endpoint'ler, kimlik doğrulama, yanıt formatı
  • Yalnızca Test Verisi — Gerçek hesapları veya canlı piyasaları etkilemez
  • Yüksek Oran Limitleri — Üretimde 1.000'e karşılık saatte 10.000 istek
  • Deterministik Yanıtlar — Tekrarlanabilir testler için tutarlı test verileri
  • İzole Hesaplar — Üretim kullanıcı verilerinden ayrı

En İyi Uygulama: Tüm geliştirme, test ve hazırlık aşamalarında sandbox ortamı kullanılmalıdır. Üretim ortamı yalnızca kapsamlı sandbox doğrulamasından sonra kullanılmalıdır.

Sandbox Özellikleri

Gerçekçi Test Verisi

Sandbox, rastgele değişmeyen gerçekçi kripto para piyasası verileri içerir:

  • Geçmiş piyasa verileri (6 aylık gerçekçi OHLCV)
  • Tutarlı hareket desenlerine sahip sabit balina cüzdan adresleri
  • Saatlik sıfırlanan sabit fonlama oranları
  • Edge case'leri test etmek için deterministik likidasyon desenleri

Teste Özel Özellikler

Test Özellikleri
// Deterministik test sembolleri
// Tüm test sembolleri TEST_ ile başlar
TEST_BTC, TEST_ETH, TEST_SOL, vb.
// Senaryo simülasyonu için sihirli zaman damgaları
GET /v1/derivatives/funding-heatmap?
timestamp=1234567890000 // Sabit test verisi döndürür
// Hata işleme testi için hata zorlama
X-Test-Error: rate_limit_exceeded
X-Test-Error: service_unavailable

Test Araçları

  • Veri Sıfırlama — Tüm test hesaplarını başlangıç durumuna sıfırla
  • Zaman Kontrolü — Farklı piyasa koşullarını simüle et
  • Hata Enjeksiyonu — Belirli hata yanıtlarını zorla
  • Oran Limit Testi — Oran limiti yanıtlarını tetikle
30 saniyede API anahtarınızı alın

Geliştirmeye hazır mısınız? Ücretsiz bir API anahtarı alın (günde 50 çağrı, kart gerekmez) ve canlı balina, fonlama ve zincir üstü verileri çekmeye başlayın.

API anahtarınızı alın →

Test Kimlik Bilgileri

Test API Anahtarlarını Alma

Sandbox API anahtarları oluşturmak için kontrol paneli üzerinden bir test hesabı oluşturun:

Test Anahtar Formatı
// Test anahtarlarının farklı bir öneki vardır
sk_test_1234567890abcdef // Test API anahtarı
sk_live_1234567890abcdef // Üretim API anahtarı
// Otomatik olarak uygun ortama yönlendirir
GET https://api.smartmoneyapi.com/v1/whales
-H "Authorization: Bearer sk_test_xxx"
# Otomatik olarak sandbox'a yönlendirir

Önceden Yapılandırılmış Test Anahtarları

Hızlı denemeler için bu genel test anahtarlarını kullanın (oran sınırlı):

Anahtar İzinler Limit
sk_test_demo Tümünü oku 100/saat
sk_test_trader Okuma + uyarılar 500/saat
sk_test_pro Tam erişim 5000/saat

Test anahtarlarını üretimde asla kullanmayın. Sınırlı işlevselliği ve oran limitleri vardır.

Test Verisi ve Sabitler

Mevcut Test Sembolleri

Sandbox, gerçekçi geçmiş verilere sahip şu test işlem çiftlerini içerir:

Test Sembolleri
// Kripto para çiftleri
TEST_BTCUSDT, TEST_ETHUSDT, TEST_BNBUSDT
TEST_SOLSDT, TEST_ARBUSDT, TEST_OPUSDT
// Test sembollerini sorgula
GET /v1/symbols?test_only=true

Test Balina Cüzdanları

Deterministik davranışa sahip önceden yapılandırılmış test cüzdanları:

  • Biriktirici Cüzdan — Sürekli alım yapar, yükseliş testleri için iyidir
  • Dağıtıcı Cüzdan — Sürekli satım yapar, düşüş testleri için iyidir
  • Osilatör Cüzdan — Alım/satım dönüşümlü yapar, range-bound testler için iyidir
  • Volatilite Cüzdan — Stres testi için rastgele büyük işlemler yapar

Test Verisini Sıfırlama

Test Verisini Sıfırla
// Tüm test hesaplarını başlangıç durumuna sıfırla
POST /v1/test/reset
-H "Authorization: Bearer sk_test_xxx"
// Belirli bir kaynağı sıfırla
POST /v1/test/reset?resource=whales
// Yanıt
{
"status": "reset_complete",
"timestamp": 1709980800000
}

Sandbox Endpointleri

Temel URL'ler

Ortam URL'leri
// Sandbox (test modu)
https://api-test.smartmoney.io/v1
// Veya sorgu parametresi kullanın
https://api.smartmoneyapi.com/v1?environment=sandbox
// Production (canlı mod)
https://api.smartmoneyapi.com/v1

Yalnızca Sandbox Endpointleri

Endpoint Amaç
POST /test/reset Test verilerini başlangıç durumuna sıfırla
POST /test/inject-error Test için belirli bir hata enjekte et
POST /test/simulate-time Farklı piyasa koşullarını simüle et
GET /test/status Sandbox ortamının sağlığını kontrol et

Yanıt Taklidi

Test Hataları Enjekte Etme

İstisna işleme testleri için belirli hata yanıtlarını zorla:

Hata Enjeksiyonu
// Oran sınırı işleme testi
GET /v1/whales?X-Test-Error=rate_limit_exceeded
// Hizmet kullanılamazlığı testi
GET /v1/whales?X-Test-Error=service_unavailable
// Kimlik doğrulama hatası testi
GET /v1/whales?X-Test-Error=invalid_key
// Zaman aşımı testi
GET /v1/whales?X-Test-Error=timeout

Mevcut Test Hataları

Hata Kodu HTTP Durumu Kullanım Senaryosu
invalid_key 401 Kimlik doğrulama hatası işleme
rate_limit_exceeded 429 Geri çekilme mantığı testi
not_found 404 Eksik kaynak işleme
service_unavailable 503 Yeniden deneme mantığı testi
timeout 504 Zaman aşımı işleme

Sandbox Oran Sınırları

Oran Sınırı Katmanları

Ortam Sınır/Saat Patlama Amaç
Sandbox 10,000 500/dak Geliştirme & test
Production Free 1,000 50/dak Hobi projeleri
Production Trader 10,000 400/dak Profesyonel ticaret
Production Pro 50,000 1000/dak Yüksek frekanslı sistemler

Oran Sınırı İşleme Testi

Oran Sınırı Testi
// Sandbox'ta oran sınırı yanıtını tetikle
curl -H "X-Test-Error: rate_limit_exceeded" \
https://api-test.smartmoney.io/v1/whales
// Yanıt yeniden deneme başlıklarını içerir
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709984400
Retry-After: 3600

Test Stratejileri

Unit Testler ile Fixture'lar

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

Entegrasyon Testi

Production dağıtımı öncesinde sandbox'ta tam iş akışını test edin:

  1. Sandbox kimlik bilgileriyle staging'e dağıtın
  2. Sandbox'a karşı tam test paketini çalıştırın
  3. Hata enjeksiyonu ile hata işlemeyi test edin
  4. Oran sınırlama davranışını doğrulayın
  5. Yanıt süresini ve gecikmeyi kontrol edin
  6. Ancak o zaman production'a geçin

Yük Testi

Apache Bench ile Yük Testi
// Sandbox yüksek yük testine izin verir
ab -n 5000 -c 100 \
-H "Authorization: Bearer sk_test_pro" \
https://api-test.smartmoney.io/v1/whales/TEST_BTC

CI/CD Entegrasyonu

GitHub Actions Örneği

.github/workflows/test.yml
name: API Testleri
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/

Ortam Yapılandırması

Sandbox ve production arasında geçiş yapmak için ortam değişkenlerini kullanın:

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

Sorun Giderme

Yaygın Sorunlar

Test Anahtarı Çalışmıyor

Sorun: Test anahtarı ile 401 Yetkisiz hatası alınıyor

Çözümler:

  • Anahtarın sk_test_ ile başladığını doğrulayın (sk_live_ değil)
  • Authorization başlık formatını kontrol edin: "Bearer sk_test_xxx"
  • Test endpointini kullandığınızdan emin olun: api-test.smartmoney.io
  • Test anahtarının oran limitini aşmış olabilir

Veriler Sıfırlanmıyor

Sorun: POST /test/reset sonrası test verileri sıfırlanmıyor

Çözümler:

  • Sıfırlama işleminin yayılması 30 saniyeye kadar sürebilir
  • Sandbox durumunu GET /test/status ile kontrol edin
  • Doğru test API anahtarını kullandığınızı doğrulayın
  • Sorun devam ederse destekle iletişime geçin

Sandbox'ta Oran Limitleri

Sorun: Sandbox'ta oran limitlerine ulaşılıyor (olmamalı)

Çözümler:

  • sk_test_pro anahtarını kullandığınızı doğrulayın (10,000/saat)
  • X-RateLimit-Remaining başlığını kontrol edin
  • Saat sınırını bekleyin veya farklı bir test hesabı kullanın
  • Geçici oran limiti artışı için destekle iletişime geçin

Bugün Teste Başlayın

Güvenli, izole geliştirme için kapsamlı sandbox ortamımızı kullanın. Deterministik test verileri, yüksek oran limitleri ve production ile tam özellik uyumu.

Test Kimlik Bilgilerini Alın
Tüm planlar sandbox erişimi içerir. Ekstra ücret yok.

İlgili Kaynaklar

Kimlik Doğrulama Rehberi →

API kimlik doğrulama ve anahtar yönetimi

REST API Referansı →

Tam API endpoint dokümantasyonu

Hata Kodları →

Hata işleme ve yanıt kodları
Ücretsiz başlayın — günde 50 çağrı, kart gerekmez

3 borsadan canlı balık akışı, fonlama, açık pozisyon ve zincir üstü verilerini tek bir API'den alın. Ücretsiz katman, kredi kartı gerekmez, istediğiniz zaman yükseltin.

Ücretsiz başlayın →
Canlı API konsolunu deneyin → (hesap gerekmez)