Değişiklik Günlüğü

Partner API'de entegratörlerin aksiyon alması gereken değişiklikler, en yeniden eskiye.

2026-11-09: Dokümantasyon API ile uyumlu hale getirildi

Bu sayfalar artık partner API'yi bugün çalıştığı haliyle anlatır. Aşağıdaki değişikliklerin çoğu son aylarda dokümante edilmeden yayına alındı; entegrasyonunuz bu sayfaların eski sürümlerine göre yapıldıysa her maddeyi gözden geçirin. Postman koleksiyonu yeniden üretildi ve tüm endpoint'leri kapsıyor.

Kimlik doğrulama

• Bir client'ın tek bir geçerli access token'ı vardır. Hangi grant ile olursa olsun yeni bir token almak öncekini geçersiz kılar. Refresh token'lar tek kullanımlıktır: tüketilmiş ya da geçersiz kalmış bir refresh token 400, kod 10006 ile reddedilir. Bkz. Token Oluşturma.
• Client sertifikaları TLS el sıkışmasında sunulur. X-Client-Cert başlığı artık kabul edilmez. Bkz. mTLS Client Sertifikaları.
• Client'ın IP izin listesi dışından gelen çağrı 401 (403 değil) ile reddedilir.

Hatalar

• Hatalar {code, domain, message} biçimindedir; doğrulama hatalarında ek olarak details bulunur. Aynı code birden fazla domain'de bulunur: bir hatayı domain + code ile tanımlayın.
• "Bulunamadı" hatalarının çoğu 404 değil, alanın kendi koduyla 400 döner. Her endpoint sayfası kendi kodlarını listeler. Bkz. Hatalar.

Cüzdan ve ağ her zaman çağıran tarafından seçilir

• Zincir üzerinde imza atan her işlem wallet_id alır, işlemi başlatan isteklerde network_id de alır: kullanıcı alımları (birincil ve ikincil piyasa), OTC ve ikincil piyasa satışı, kullanıcı yakma, kira tahsili, kullanıcı ve düğüm para çekme, kurulum oluşturma, para birimi token'ı oluşturma, KYC token ve token geri çağırma. İptal ve listeden çıkarma, teklif ya da listelemede kayıtlı cüzdanla imzalanır. Yedek cüzdan yoktur.
• Kullanıcılar artık address taşımaz. Adresler cüzdanlarda bulunur ve bir kullanıcının aynı zincirde birden fazla olmak üzere birçok cüzdanı olabilir.

Taşınan ya da kaldırılan route'lar

Önce	Şimdi
/v2/admin/kyc/groups/**	/v2/admin/kycs/{kyc_token_id}/groups/** (yalnızca platform sahibi)
/v2/admin/kyc/tokens	/v2/admin/kyc-tokens
/v2/admin/kyc/nodes/{node_id}/addresses	GET /v2/admin/nodes/{node_id}/kyc/addresses
POST /v2/admin/tokens/nodes/{node_id}/search	GET /v2/admin/tokens?node_id=…
POST /v2/users/tokens/search	GET /v2/users/tokens?node_id=…
GET /v2/admin/currency-tokens/active	GET /v2/admin/currency-tokens?is_active=true
/v2/admin/fees/owner, /fees/platform-owner/defaults, /fees/nodes/{node_id}/defaults, /fees/nodes/{node_id}/platform-owner/defaults	GET /v2/admin/fees?entity=…
/v2/admin/oracles/categories/{category_id}	GET /v2/admin/oracles?category_id=…
POST /v2/admin/categories/{category_id}/children/search	GET /v2/admin/categories/{category_id}/children?page=…&per_page=…
/v2/admin/otc-order-rules/nodes/{node_id}[/tokens/{token_id}]	GET /v2/admin/otc-order-rules?node_id=…&token_id=…
Düğüm bazlı OTC listelemeleri	GET /v2/admin/otcs?node_id=…, GET /v2/admin/otcs/tokens/{token_id}
Düğüm seviyesinde kontrat durumu ve yükseltme	Kurulum bazında: /v2/admin/nodes/{node_id}/setups/{setup_id}/contracts/…
PUT /v2/users/{user_id}/wallet, cüzdan adresi + imza ile güncelleme	Kaldırıldı. PATCH /v2/users/{user_id}/wallets/{wallet_id} yalnızca yeniden adlandırır
/v2/users/{user_id}/wallets/{wallet_id}/currency-tokens/{currency_token_id}	/v2/users/{user_id}/wallets/{wallet_id}/networks/{network_id}/assets/{asset_id}
/v2/blockchain/… zincir kataloğu	GET /v2/chains, GET /v2/networks
POST /v2/webhooks	POST /v2/webhooks/custodial (eski yol kullanımdan kalkmış bir takma addır)

Listelemeler

• Her listeleme page ve per_page (ikisi de zorunlu, per_page en fazla 100) alan bir GET isteğidir ve {data, total, page, per_page} döner. Hiçbir kayıtla eşleşmeyen bir filtre boş sayfa döner.

Asenkron işlemler

• Token işlemleri (listeleme, listeden çıkarma, pasif, yakma, kira, public transfer, OTC'ye açma, ikincil piyasaya açma), token ve metrik güncellemeleri, para birimi token'ı deploy, mint ve gönderimi ile OTC kabul ve iptali sorgulanacak {"transaction_id": "…"} döner. Token oluşturma 201 ile {token_id, transaction_id} döner.
• Kullanıcı yakma ve kira tahsili boş bir 200 döner; kullanıcının transaction'larını sorgulayın. Düğüm para çekme null döner; düğümün transaction'larını sorgulayın.

Kurulumlar ve kontratlar

• Deploy POST /v2/admin/nodes/{node_id}/setups ile başlar (wallet_id ve network_id zorunlu). Her çağrı yeni bir kurulum oluşturur. POST …/setups/{setup_id}/deploy gövde almaz ve yalnızca bir deploy'u yeniden dener ya da sürdürür.

Token'lar

• Token oluşturma gövdede node_id, setup_id ve network_id (kurulumun ağı) alır; kurulumun cüzdanı imzalar.
• Token güncelleme ve metrik güncelleme her alanı yazar: gönderilmeyen bir sayı 0 olarak kaydedilir. Her zaman alanların tamamını gönderin.

Para birimi token'ları

• Oluşturma node_id, network_id ve wallet_id alır, aynı çağrıda deploy eder ve token'ı taslak durumunda 201 ile döner. /deploy yalnızca başarısız bir deploy'u yeniden dener.

Ücretler

• Ücret yüzdeleri en fazla bir ondalık basamaklı string'lerdir. Her yazma işlemi dokuz değerin tamamını ister, kapsamını route'tan alır ve kaydedilen satırla 200 döner. Kurulum bazlı ücret endpoint'leri, geçerli ücretler ve etkilenen kurulum sayısı yenidir. Bkz. ücret genel bakışı.

Kullanıcı piyasa işlemleri

• OTC ve ikincil piyasa satışı price_id ve price_amount yerine currency_token_id ve unit_price alır.
• OTC iptali ve ikincil piyasadan çıkarma işlemi path'te deal'i belirtir (…/deals/{deal_id}/cancel, …/deals/{deal_id}/delist) ve gövde almaz.
• Yeni alım fiyat teklifi endpoint'leri, almadan önce fiyat dökümünü döner.

Zincir verisi

• GET /v2/blockchain/gas-fee artık node:summary:view izinli bir token ve bir network_id ister. max_fee ve max_priority_fee yerine safe_gas_price, propose_gas_price ve fast_gas_price döner; gerçek zamanlı gas_fee mesajı da aynı şekilde değişti.
• Analiz yanıtları camelCase alan adları kullanır.

Yeni dokümante edilen endpoint'ler

Düğüm kurulumları ve cüzdanları, cüzdan varlıkları, sahiplik değişikliği süreçleri, platform sahibi cüzdanları ve ayarları, analizler, token depozitoları, kiralar, yakma ödemeleri, yatırımcılar, yeniden tokenize etme ve tokenizasyon görselleri, KYC token'ları, kurulum bazlı ücretler, oracle CRUD, oracle metrikleri, kategori yazma işlemleri, custody / spot fiyat / AI sağlayıcı ayarları, kullanıcı listeleme ve cüzdanları, alım fiyat teklifleri, zincirler, ağlar ve gas sponsor cüzdanları.

2026-10-21: Parasal değerler ondalık string olarak taşınıyor

Partner API'deki (/v2/admin/**, /v2/users/** ve webhook'lar) her parasal değer artık "12.5" gibi bir ondalık string'dir. Alan adları ve /v2 yolları değişmedi. Kurallar, hatalı bir değer için dönen hata ve örnekler Tutarlar ve Yüzdeler sayfasındadır.

Neler değişti?

• Fiyat nesneleri {id, amount, decimal, symbol, address}: amount (token token_price, total_value, salable_value, rental_income, …).
• Token salable_percentage.
• Ücretler: ücret value yüzdeleri (0 ile 100 arası, en fazla bir ondalık basamak, "2.5" = %2,5); OTC, ikincil piyasa ve satın alma kırılımlarındaki ücret amount ve percentage alanları.
• Fiyatlar: min_sell_price, max_sell_price, min_price, max_price, unit_price, price_amount.
• OTC emir kuralları: above_amount, below_amount, above_percent, below_percent.
• Cüzdan özetleri: bakiyeler ile usd / try değerlemeleri.
• Analitik hacimleri ve ücret gelirleri.
• Para birimi tokenları: total_supply; mint, send ve withdraw amount. Node withdraw amount.
• Satın alma fiyat teklifleri: birim fiyat, ara toplam, toplam, satıcıya kalan tutar.
• Token geçmişindeki start_value, end_value, rate; spot fiyatlar; gas ücreti teklifleri.

Tam token sayıları (quantity, max_supply, listed_supply, sold_supply, purchased_supply, en az ve en fazla satın alma miktarı), decimal, page, per_page, type, status ve zaman damgaları JSON sayısı olarak kalır.

Geçiş politikası

• Yanıtlar bu alanları bu sürümden itibaren string olarak ve her zaman en kısa biçimde döndürür ("12.5"; asla "12.50" ya da "1e-7" değil). İstemciniz bunları sayı olarak okuyorsa onu şimdi güncelleyin.
• İstekler string göndermelidir. JSON sayısı şimdilik kabul edilmeye devam ediyor. Sayı desteği ileriki bir sürümde sona erecek. Tarih bu günlükte en az 30 gün önceden duyurulacak.
• Hatalı bir değer ya da birden fazla ondalık basamaklı bir ücret yüzdesi, HTTP 400 ve 10015 koduyla (invalid request payload) reddedilir. Bir details girdisi {field, message}, ihlal edilen kuralı belirtir.
• Para birimi tokenı mint işlemi tam adet alır. SToken kontratı yalnızca tam adet basar; bu yüzden "12.5" gibi kesirli bir amount artık 10015 ile reddedilir. Önceden kabul ediliyor ve işlem hiçbir şey basmadan tamamlanıyordu.
• Secondary market alımı (/v2/users/**) bir listelemeyi bütün olarak alır: quantity listelemenin miktarına eşit olmalıdır, başka bir değer HTTP 400 ve 11004 koduyla reddedilir. Kontrat her zaman listelemenin tamamını aktarır; farklı bir miktar önceden kabul ediliyor ve yanlış tutarda ödeme onayı veriyordu.