İçindekiler

Genel Bakış Sürüm Politikası Geriye Dönük Uyumluluk V1'den V2'ye Geçiş Endpoint Değişiklikleri Yanıt Formatı Güncellemeleri Kullanımdan Kaldırma Takvimi Yıkıcı Değişiklikler Adım Adım Geçiş Destek & Kaynaklar

API Dokümantasyonu

API Geçiş Rehberi — Sürümler Arasında Yükseltme

API sürüm yükseltmelerini sorunsuzca planlayın ve uygulayın. Smart Money API sürümleri arasında geçiş yaparken yıkıcı değişiklikleri, kullanımdan kaldırma takvimlerini ve en iyi uygulamaları anlayın.

21 Mart 2026 tarihinde yayınlandı • 16 dakikalık okuma • İleri Düzey

Geçişe Genel Bakış

Smart Money API düzenli güncellemelerle aktif olarak geliştirilmektedir. Bu rehber, sürüm yönetimini, yıkıcı değişiklikleri ve entegrasyonunuzu kesinti yaşamadan nasıl geçireceğinizi kapsar.

Geçişin temel ilkeleri:

Semantik Sürümleme — MAJOR.MINOR.PATCH formatı sıkı bir şekilde takip edilir
Uzun Vadeli Destek — Önceki ana sürüm 24+ ay boyunca desteklenir
Kullanımdan Kaldırma Uyarıları — Tüm yıkıcı değişiklikler için 6 ay önceden bildirim
Paralel Sürümler — Geçiş sırasında v1 ve v2 aynı anda çalıştırılabilir
Otomatik Testler — Test uyumluluk araçları sağlanır

Mevcut Durum: v1 (mevcut), v2 (beta, genel kullanıma açılma Q2 2026). v1, Q1 2028'e kadar desteklenecek.

Sürüm Politikası

Semantik Sürümleme

Sürüm Formatı
API Sürümü: MAJOR.MINOR.PATCH
Örnek: 2.1.3
MAJOR (2) - Yıkıcı değişiklikler, yeni mimari
MINOR (1) - Geriye dönük uyumlu özellikler
PATCH (3) - Hata düzeltmeleri, güvenlik güncellemeleri

Sürüm Yayın Döngüsü

Aşama	Süre	Özellikler
Alpha	2-4 hafta	Yoğun yıkıcı değişiklikler, yalnızca test
Beta	4-8 hafta	Çoğunlukla stabil, topluluk geri bildirimi
Release Candidate	2-4 hafta	Üretime hazır, son rötuşlar
Genel Kullanıma Açılma	24+ ay	Tam üretim desteği

API anahtarınızı 30 saniyede alın

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

API anahtarınızı alın →

Geriye Dönük Uyumluluk

Sürüm Uyumluluğu

Bir ana sürüm içinde, her zaman daha yeni minor/patch sürümlerine güvenle yükseltebilirsiniz:

Endpoint URL'leri — Değişmez
Gerekli Alanlar — Asla kaldırılmaz (yalnızca yeni opsiyonel alanlar eklenir)
HTTP Durum Kodları — Mevcut senaryolar için korunur
Yanıt Yapısı — Temel alanlar aynı kalır
Kimlik Doğrulama — Kimlik doğrulama mekanizmalarında değişiklik yok

Zarif Kullanımdan Kaldırma

Kullanımdan Kaldırma Takvimi
// Ay 1: Kullanımdan kaldırma duyurusu
// Özellik Deprecation başlığı ile işaretlenir
Deprecation: version="2.2", sunset="2026-09-01"
// Ay 3-6: Aktif kullanımdan kaldırma dönemi
// API uyarıları döndürür ancak çalışmaya devam eder
X-Deprecation-Warning: Bu endpoint 2026-09-01 tarihinde kaldırılacaktır
// Ay 6: Son kaldırma
// Endpoint 410 Gone döndürür
HTTP/1.1 410 Gone

V1'den V2'ye Geçiş

Önemli Değişiklikler

REST API Yeniden Tasarımı — Daha temiz kaynak endpoint'leri
Yanıt Formatı — Tutarlı sarmalama, daha iyi hata yönetimi
Kimlik Doğrulama — OAuth 2.0 desteği eklendi (API anahtarları hala çalışır)
Oran Sınırlama — Geliştirilmiş detay ve netlik
Webhooks — Yeniden tasarlanmış olay formatı ve imzalama

Endpoint Eşleme

v1 Endpoint	v2 Endpoint	Değişiklikler
GET /whales	GET /v2/whales/tracking	Yeniden düzenlendi, filtreleme eklendi
GET /funding	GET /v2/derivatives/funding-heatmap	Exchange parametresi zorunlu
GET /positions	GET /v2/derivatives/positions	Yeni toplama seçenekleri

Endpoint Değişiklikleri

İstek Parametre Değişiklikleri

V1 İsteği
// V1: Fonlama oranları
GET /v1/funding?symbol=BTCUSDT&exchange=binance

V2 İsteği
// V2: Aynı veri, daha net yapı
GET /v2/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance

Yanıt Formatı Güncellemeleri

V1 Yanıt Yapısı

V1 Format
{
 "status": "success",
 "data": {
 "symbol": "BTCUSDT",
 "funding": 0.0001
  }
}

V2 Yanıt Yapısı

V2 Format
{
 "data": {
 "symbol": "BTCUSDT",
 "funding_rate": 0.0001
  },
 "_meta": {
 "request_id": "req_abc123",
 "timestamp": 1709980800000
  }
}

Temel Farklar: Durum sarmalayıcı yok, daha net alan isimleri, standartlaştırılmış meta veriler.

Kullanımdan Kaldırma Takvimi

Planlanan Kullanımdan Kaldırmalar

Özellik	Duyuruldu	Son Kullanım Tarihi	Yedek
/v1/whales	Oca 2026	Oca 2028	/v2/whales/tracking
/v1/funding	Oca 2026	Oca 2028	/v2/derivatives/funding-heatmap
Sadece API anahtarı ile kimlik doğrulama	Mar 2026	Mar 2027	OAuth 2.0 (anahtarlar hala çalışıyor)
Webhook v1 formatı	Q2 2026	Q2 2027	Webhook v2 formatı

Yıkıcı Değişiklik Detayları

Kaldırılan Uç Noktalar

/v1/stats — /v2/metrics ile değiştirildi
/v1/historical — Yeni parametrelerle /v2/historical ile değiştirildi
/v1/alerts/create — POST /v2/alerts ile değiştirildi

Parametre Değişiklikleri

limit — Varsayılan 100'den 20'ye değiştirildi (açık olun!)
timeframe — Artık tarihsel sorgularda zorunlu
sort — Format "field asc" yerine "field:asc" olarak değiştirildi

Yanıt Alanı Değişiklikleri

funding → funding_rate
price → mark_price
vol → volume_quote

Adım Adım Geçiş

Aşama 1: Planlama (Hafta 1-2)

Kullanımdan kaldırılan özellikler için mevcut entegrasyonu denetle
v1 uç noktalarını v2 eşdeğerleriyle eşleştir
Kodunuzu etkileyen yıkıcı değişiklikleri belirle
Test stratejisi ve zaman çizelgesini planla

Aşama 2: Geliştirme (Hafta 3-4)

Sürüm kontrolünde v2 dalı oluştur
Tüm API uç noktalarını v2 URL'lerine güncelle
İstek/yanıt işleme güncellemeleri yap
Unit testleri sandbox ortamında çalıştır

Aşama 3: Test (Hafta 5-6)

Tam entegrasyon test paketini çalıştır
Hata senaryolarını ve özel durumları test et
v2 uç noktalarıyla yük testi yap
Güncellenen kod için güvenlik denetimi yap

Aşama 4: Hazırlık (Hafta 7)

v2 kodunu hazırlık ortamına dağıt
Tam kabul testlerini çalıştır
Paydaşlardan onay al
Geri dönüş planı hazırla

Aşama 5: Prodüksiyon (Hafta 8)

Prodüksiyona mavi-yeşil dağıtım yap
Metrikleri ve hata oranlarını izle
Destek sorunları için hazır bulun
v1 kodunu kademeli olarak devre dışı bırak

Destek & Kaynaklar

Mevcut Araçlar

Geçiş Doğrulayıcı — Kullanımdan kaldırılan kullanım için kodu kontrol et
API Yükseltme Kontrolü — v1 ve v2 uyumluluğunu karşılaştır
Geçiş Kontrol Listesi — Görevler ve zaman çizelgesi içeren PDF
Kod Örnekleri — Geçiş öncesi/sonrası örnekler

Yardım Alma

Email: [email protected]
Dokümantasyon: changelog-versioning.html'ye bakın
Discord: Topluluk destek kanalı
Kurumsal: Özel geçiş mühendisi

Geçişinize Bugün Başlayın

Kapsamlı geçiş araçları, dokümantasyon ve destek ile API v2'ye yükseltin. Sıfır kesinti süresi ile geçişi destekler.

V2'yi Keşfet

V1, Oca 2028'e kadar desteklenmektedir. Geçişinizi bugün planlayın.