SwapSpace API vs. Changelly API: geliştiriciler için eksiksiz karşılaştırma

Bir cüzdana veya Web3 ürününe swap işlevi eklemek, kullanıcı deneyiminden çok daha fazlasını etkiler. Seçilen API, backend’in fiyat teklifi isteme, süresi dolmuş oranları işleme, işlemleri izleme ve bir rota kullanılamadığında nasıl yanıt vereceğini belirler. Ayrıca bir exchange geciktiğinde, iade edildiğinde veya doğrulama için duraklatıldığında destek iş yükünü de şekillendirir.

Bu Changelly API vs SwapSpace API karşılaştırması, cüzdanlar, exchange’ler ve diğer Web3 ürünleri geliştiren geliştiriciler için önemli olan teknik farkları inceliyor.

Karşılaştırma, her sağlayıcının herkese açık dokümantasyonunu ve güncel B2B sayfalarını kullanır. Varlık kullanılabilirliği, istek limitleri, ticari şartlar ve uyumluluk kuralları değişebilir. Lansmandan önce bunları canlı API ve partner anlaşmanız üzerinden doğrulayın.

Changelly API nedir?

Changelly API v2, tek bir Changelly fiyat teklifi ve işlem servisinden oluşan white-label bir kripto para exchange API’sidir.

• Protokol: imzalı POST istekleri üzerinden JSON-RPC 2.0.
• Kimlik doğrulama: X-Api-Key artı RSA-SHA256 imzası, partner hesabı ve açık anahtar kaydı ile.
• Oran modelleri: ayrı sabit oran ve değişken oran yöntemleri.
• Varlık kapsamı: herkese açık B2B sayfasında 1.000’den fazla varlık, canlı etkin set ise API tarafından döndürülür.
• İlgili ürünler: ayrı fiat API, widget ve checkout servisleri.

API, sağlayıcı seçimini uygulamanın dışında tutar. Sabit ve değişken tahminler farklı yöntemler kullanır ve sabit fiyat teklifleri kısa bir geçerlilik penceresi taşır. Bu ayrımlar işlem oluşturma adımına kadar taşınır. Temel uygulama farkı rota sıralamasından ziyade istek imzalamadır.

SwapSpace API nedir?

SwapSpace API v2, tek bir entegrasyon üzerinden birden fazla exchange partnerinin tekliflerini sunan bir REST API’sidir.

• Protokol: para birimleri, partnerler, tutarlar, exchange oluşturma ve durum için kaynak bazlı REST endpoint’leri.
• Kimlik doğrulama: Authorization başlığında bir API anahtarı, her affiliate için yapılandırılmış istek limitleri ile.
• Oran modelleri: sabit ve değişken teklifler, partner filtreleri ve Best Amount seçeneği.
• Varlık kapsamı: herkese açık B2B sayfasında 675 ağda 3.600’den fazla varlık ve 40’tan fazla likidite kaynağı, canlı rota doğrulaması gerekir.
• İlgili ürünler: bir exchange widget’ı ve özel transferler, özel transfer erişimi ayrı ayrı doğrulanır.

Her teklif, partner ve rota verileriyle birlikte gelir. Bir uygulama birden fazla teklifi gösterebilir, filtreleyebilir veya daha basit bir seçim yöntemi kullanabilir. Teklif kimlikleri kısa ömürlü olabilir ve sağlayıcı meta verileri iade adresi gereksinimlerini değiştirebilir. Bu rota düzeyindeki veri, Changelly’nin tek servis sözleşmesine kıyasla temel mimari farktır.

Bir bakışta Changelly API vs SwapSpace API karşılaştırması

Bu exchange API karşılaştırması, bir geliştiricinin herkese açık dokümantasyonda doğrulayabileceği entegrasyon yüzeyine odaklanır.

Likidite mimarisi: tek sağlayıcı API’si vs toplayıcı

Teklif seçimi ve şeffaflık

Changelly likiditeyi kendi altyapısı genelinde kaynaklayabilir, ancak partner API’si hizmet sınırı olarak Changelly’yi açığa çıkarır. Uygulamanız bir tahmin ister ve istenen yöntem ve çift için tek bir sonuç alır. Bu, teklif modelini kompakt tutar. Ürün, sağlayıcıları sıralamak veya neden iki sağlayıcının farklı limitler döndürdüğünü açıklamak zorunda kalmaz.

SwapSpace likidite toplayıcılığını doğrudan açığa çıkarır. Amounts endpoint’i tüm mevcut partnerlerden veya seçilmiş partner listesinden teklifler döndürebilir. Yanıt, aynı çift için sabit ve değişken rotalar içerebilir. Bu, bir cüzdana veya exchange’e sıralama üzerinde daha fazla kontrol verir. Bir ürün varış miktarına, tahmini süreye, sağlayıcı politikasına veya kendi iş kurallarına göre sıralama yapabilir.

Bir hedef kitle sağlayıcı seçimine veya rota şeffaflığına önem veriyorsa, bir SwapSpace entegrasyonu birden fazla teklif gösterebilir ve ürüne özgü seçim kuralları uygulayabilir. Daha basit bir ürün tek bir seçilmiş rotayı gösterebilir. Arayüz buna ihtiyaç duyduğunda sağlayıcı kimliği, oran türü, limitler ve beklenen süre yine de kullanılabilir durumda kalır.

Kullanılabilirlik ve fallback davranışı

Changelly’de bir para birimi devre dışıysa veya bir tahmin başarısız olursa, API aynı sözleşme üzerinden başka bir isimlendirilmiş sağlayıcı sunmaz. Uygulamanın başka bir rota seçmek için ayrı bir entegrasyona ihtiyacı vardır.

SwapSpace, exchange oluşturulmadan önce mevcut diğer partnerlerden teklifler döndürebilir. Bir exchange oluşturulduktan sonra seçilen sağlayıcı o işleme bağlı kalır. Bu nedenle Changelly rota bağımlılığını tek bir hizmette yoğunlaştırır. SwapSpace ise işlem öncesi fallback’i aynı API içinde sunar.

Uyumluluk ve destek sınırları

Her iki API de doğrulama ile ilgili durumları yüzeye çıkarabilir, ancak sorumluluk farklı şekilde bölünür. 

Changelly hold durumunu belgeler ve partneri kullanıcıları kendi güvenlik ekibine yönlendirmeye sevk eder. 

SwapSpace Verifying durumunu açığa çıkarır; seçilen exchange sağlayıcısı kontrolleri yönetebilir. Bu nedenle sağlayıcı kimliği ve destek talimatları toplu modelde daha fazla önem taşır.

Geliştirici deneyimi

Erişim ve kimlik doğrulama

Kimlik doğrulama, en net uygulama farkıdır ve bir kripto swap entegrasyonunun ilk aşamasını şekillendirir.

Changelly:

• Partner hesabı ve açık anahtar kaydı.
• Her JSON-RPC istek gövdesi üzerinde RSA-SHA256 imzası.
• Özel anahtarı korumak için sunucu tarafı entegrasyon.

SwapSpace:

• Affiliate hesabı ve Authorization başlığında API anahtarı.
• Onboarding sırasında affiliate için yapılandırılmış istek limitleri.
• API anahtarı için sunucu tarafı saklama.

Changelly daha fazla kurulum ve imzalama kodu gerektirir. SwapSpace daha hafif bir kimlik bilgisi modeli kullanır; ancak üretim kapasitesi affiliate yapılandırmasına bağlıdır.

Dokümantasyon ve hata işleme

Changelly dokümantasyonu:

• Yöntem düzeyinde istek şemaları ve hata örnekleri.
• Birkaç programlama dilinde kimlik doğrulama örnekleri.
• Geçiş notları ve ayrıntılı bir durum referansı.

SwapSpace dokümantasyonu:

• Para birimlerinden ve partnerlerden exchange durumuna uzanan kısa bir REST akışı.
• Tutarlar, oran kimlikleri, ekstra kimlikler, kullanıcı IP’leri ve koşullu iade adresleri için doğrulama kuralları.

Changelly daha derin kimlik doğrulama ve hata materyali sunar. SwapSpace ise daha fazla rota seçimi verisiyle daha kısa bir akış belgeler.

Changelly’nin JSON-RPC yanıtları yönteme özgü kodları ve mesajları açığa çıkarır. SwapSpace’in REST akışı ağ kimlikleri, oran kimlikleri, ekstra kimlikler, kullanıcı IP’leri ve koşullu iade adresleri gibi doğrulama alanlarını belgeler. Bu yukarı akış hatalarını arayüze ulaşmadan önce kararlı dahili kategorilere eşleyin. Destek ekibi bir rotayı izleyebilsin diye, kullanıcıya ham sağlayıcı mesajlarını göstermeden günlüklerde orijinal hata kodunu ve exchange kimliğini saklayın.

Performans ve ölçeklenebilirlik değerlendirmeleri

Changelly ilgili yöntemler için varsayılan olarak saniyede 10 istek sınırı yayınlar. Daha yüksek throughput şartları herkese açık referansta belirtilmemiştir.

SwapSpace standart bir sayısal üst sınır yayınlamaz, çünkü istek limitleri her affiliate için yapılandırılır. Bu nedenle kapasite planlaması herkese açık varsayılan yerine üzerinde anlaşılan partner yapılandırmasına bağlıdır.

Her iki herkese açık akış da polling tabanlı durum endpoint’leri sunar. Bu karşılaştırma için incelenen herkese açık referanslar genel bir webhook sözleşmesi tanımlamıyor; bu nedenle webhook kullanılabilirliği partner onboarding’inin bir parçası olarak kalır.

Polling davranışı kapasite planlamasını da etkiler. Para birimi ve partner meta verilerini tanımlı bir aralıkta önbelleğe alın, kullanıcıların üzerinde işlem yapamayacağı teklifleri yenilemekten kaçının ve işlem zaman açısından hassas aşamaları terk ettikten sonra durum kontrollerini yavaşlatın. Yük testleri teklif patlamalarını, süresi dolmuş kimlikleri, devre dışı çiftleri ve sağlayıcı tarafı hataları kapsamalıdır. Tek bir gecikme sayısı yerine tam hata yolunu benchmark edin: rotalar kaybolduğunda veya upstream yanıtlar yavaşladığında ürün yanıt verebilir kalmalıdır.

Destek ve eskalasyon

Geliştiriciler için bir kripto exchange API’sinde, destek kapsamı en çok bir işlem takıldığında veya doğrulamaya girdiğinde önem kazanır. 

Changelly teknik soruları bir partner e-postasına veya özel hesap yöneticisine yönlendirir. Dokümantasyonu, partnerin ilk seviye desteği sağladığı ve çözülemeyen vakaları özel bir Slack kanalı üzerinden Changelly’nin ikinci seviye ekibine ilettiği bir eskalasyon modelini açıklar.

SwapSpace bir partner e-postası ve B2B iletişim formu sunar; ayrıca 7/24 kullanıcı desteği sağlar. Eskalasyon yolları ve yanıt taahhütleri partner anlaşmasına bağlıdır.

Her iki API’yi entegre etmeden önce destek saatlerini, olay bildirimlerini, durum sayfası erişimini ve takılmış bir exchange’i araştırmak için gereken verileri doğrulayın.

Ticari şartlar ve gelir modeli

Her iki kripto exchange API’si de herkese açık bir entegrasyon ücreti almaz. İkisi de ek ücret veya gelir paylaşımı modeliyle partner monetizasyonunu destekler.

Changelly API partnerlerinin exchange oranına bir ücret eklemesine izin verir. iş FAQ’si 0,1% ile 5% aralığını tipik bir aralık olarak tanımlar; güncel API dokümantasyonu ise ücretin partner ekibi üzerinden yapılandırıldığını söyler.

SwapSpace’in exchange oluşturma endpoint’i isteğe bağlı bir affiliateFee parametresi içerir. Affiliate ücret oranı seçilen likidite sağlayıcısına ve partner anlaşmasına bağlıdır.

Entegrasyon iş akışı

Aşağıdaki adımlar her iki kripto swap API iş akışını ve her bir kripto API entegrasyonunun gerektirdiği mühendislik işini karşılaştırır.

Tipik Changelly entegrasyonu

1. 1. Bir Changelly partner hesabı oluşturun ve açık ile özel anahtarları üretin.
2. 2. Açık anahtarı Changelly ile kaydedin ve özel anahtarı sunucu tarafı bir secret store’da tutun.
3. 3. JSON-RPC 2.0 istek serileştirmesini ve RSA-SHA256 imzalamayı uygulayın.
4. 4. Etkinleştirilmiş para birimi verilerini alın ve ticker’ları, ağları, memo alanlarını ve doğrulama kurallarını eşleyin.
5. 5. Değişken veya sabit bir tahmin isteyin, ardından dönen tutarı ve limitleri doğrulayın.
6. 6. Teklif veya ödeme penceresi sona ermeden önce doğru işlem türünü oluşturun.
7. 7. İşlem kimliğini saklayın ve backoff ile getStatus veya getTransactions sorgulayın.
8. 8. Her terminal, iade, süre aşımı ve doğrulama durumunu bir kullanıcı mesajına ve destek prosedürüne eşleyin.

Changelly iki protokol kısıtı uygular: imza tam serileştirilmiş gövdeyle eşleşmelidir ve v2 tahminleri v2 işlem yöntemleriyle eşleşmiş kalmalıdır.

💡 Önemli! Sabit ve değişken akışlar farklı yöntemler kullanır, bu nedenle ayrı ayrı test edilmelidir.

Tipik SwapSpace entegrasyonu

1. 1. Bir affiliate hesabı oluşturun, API anahtarını alın ve hedef ortam için istek hakkını doğrulayın.
2. 2. Para birimi listesini alın ve ayrı varlık ile ağ kimliklerini saklayın.
3. 3. Partner listesini alın ve iade adresi kuralları gibi rota gereksinimlerini kaydedin.
4. 4. Çift, tutar, ağlar ve gerekli oran türleri için mevcut miktarları isteyin.
5. 5. Dönen teklifleri sıralayın veya ürünün seçim politikasına göre Best Amount endpoint’ini isteyin.
6. 6. Minimum ve maksimum değerleri doğrulayın, ardından dönen herhangi bir oran kimliği süresi dolmadan exchange’i oluşturun.
7. 7. SwapSpace exchange kimliğini, seçilen sağlayıcıyı ve kullanıcıya yönelik işlem verilerini saklayın.
8. 8. Durum endpoint’ini backoff ile sorgulayın ve tamamlandı, başarısız, iade edildi, doğrulanıyor ve süresi doldu durumlarını yönetin.

SwapSpace seçilen teklifi oluşturulan exchange’e bağlar. Yeni bir fiyat teklifi veya sağlayıcı yeni bir exchange isteği üretir.

💡 Önemli! Bir fiyat teklifi exchange oluşturulmadan önce süresi dolarsa, kullanıcı güncellenmiş teklifi onaylamalıdır.

Hangi API farklı ürünlere uyar?

Bir cüzdan için kripto API’si değerlendiren ekipler önce kullanıcıların tek bir exchange ilişkisine mi yoksa görünür sağlayıcı seçimine mi ihtiyaç duyduğuna karar vermelidir.

Tablo, ürün uygunluğunu bir başlangıç varsayımı olarak ele alır. Ticari şartlar, bölgeler, varlık talebi, trafik ve dahili mühendislik kapasitesi sonucu değiştirebilir.

Changelly API ne zaman mantıklıdır?

Changelly API, tek bir exchange servisini ve kompakt bir fiyat teklifi yanıtını tercih eden ürünlere uygundur.

Ayrıntılı imzalama örnekleri ve yöntem düzeyinde hata dokümantasyonu, net şekilde tanımlanmış bir kimlik doğrulama katmanına önem veren ekipler için faydalıdır. Aynı zamanda, Changelly’nin ayrı fiat veya checkout ürünlerini aynı B2B ilişkisi altında değerlendirmeyi planlayan şirketlere de uyabilir.

Ödünleşim rota görünürlüğüdür. API, isimlendirilmiş exchange sağlayıcılarının bir listesini değil, bir Changelly tahminini döndürür. Entegrasyon ayrıca onboarding sırasında açık anahtar kaydı gerektirir.

SwapSpace API ne zaman mantıklıdır?

SwapSpace sağlayıcı karşılaştırması ürünün bir parçası olduğunda daha güçlü bir uyum sağlar. Tek bir REST API üzerinden birden fazla teklif, sabit ve değişken seçenekler, partner filtreleri ve rota meta verileri sunar. B2B sayfası 675 ağda 40’tan fazla likidite kaynağı ve 3.600+ varlık listeler. Değer, tek bir sözleşme üzerinden daha geniş uzun kuyruk ve çapraz zincir rota kapsamıdır.

Bir ürün birden fazla teklif alıp rotayı kendi seçiyorsa, entegrasyon açık seçim kriterleri, teklif süresi dolma işlemi ve sağlayıcıya özgü exchange verileri gerektirebilir. Best Amount veya daha basit bir akış kullanan ürünler, bu yönlendirme mantığının daha fazlasını kullanıcı arayüzünün dışında tutabilir.

Son karar

Evrensel bir en iyi swap API’si yoktur. 

Changelly JSON-RPC 2.0, RSA-SHA256 istek imzalama ve tek sağlayıcılı bir teklif modeli kullanır. Ayrıntılı yöntem ve hata dokümantasyonu sunar, ancak aynı API üzerinden rakip sağlayıcı rotalarını açığa çıkarmaz. 

SwapSpace API anahtarı kimlik doğrulamalı REST kullanır ve birden fazla exchange partnerinden teklif döndürerek ürünlere rota seçimi üzerinde daha fazla kontrol ve daha geniş varlık kapsamı sağlar.

Tek bir sağlayıcı ilişkisini, kompakt bir teklif akışını ve ayrıntılı yöntem düzeyi dokümantasyonu tercih eden ürünler için Changelly’yi seçin. Sağlayıcı karşılaştırması, likidite toplama veya daha geniş uzun kuyruk rota kapsamı gerektiren cüzdanlar, exchange’ler ve Web3 ürünleri için SwapSpace’i seçin.

SwapSpace API entegrasyonunuza başlayın

Erişim, istek limitleri ve entegrasyon gereksinimlerini ürün ve iş geliştirme ekipleriyle görüşmek için SwapSpace B2B sayfasındaki formu gönderin. 

Sık sorulan sorular

SwapSpace API ile Changelly API arasındaki fark nedir?

Changelly, white-label exchange servisini JSON-RPC 2.0 üzerinden sunar. Uygulama Changelly tahminleri alır ve Changelly işlemleri oluşturur. SwapSpace, REST API üzerinden birden fazla partner teklifi sunar; bu da uygulamanın bir exchange oluşturmadan önce rotaları karşılaştırmasına veya filtrelemesine olanak tanır.

SwapSpace API birden fazla likidite sağlayıcısını toplar mı?

Evet. Amounts endpoint’i tüm mevcut partnerlerden teklif döndürebilir veya seçilen partnerlere göre filtreleyebilir. Herkese açık B2B sayfasında 40’tan fazla likidite kaynağı listelenir. Kullanılabilirlik varlığa, ağa, tutara, oran türüne ve güncel sağlayıcı koşullarına göre değişir.

Kripto cüzdanlar için hangi API daha iyidir?

Bu, cüzdanın ürün tasarımına bağlıdır. Changelly, tek bir teklif ve sağlayıcı ilişkisi isteyen bir cüzdana uyar. SwapSpace, sağlayıcı karşılaştırması, daha geniş rota kapsamı veya kendi teklif sıralama mantığını isteyen bir cüzdana uyar. Uygunluk ayrıca cüzdanın yaygın ve uzun kuyruk çiftlerinin kapsamına da bağlıdır.

Kendi exchange’inizi kurmadan kripto swap’ları entegre edebilir miyim?

Evet. Her iki API de bir ürünün exchange yürütmesini dışarıya devretmesine, ancak arayüz ve backend orkestrasyonu üzerinde kontrolü elinde tutmasına olanak tanır. Adres doğrulama, durum işleme ve destek, ürün entegrasyonunun bir parçası olarak kalır.

SwapSpace API sabit ve değişken oranları destekliyor mu?

Evet. Amounts endpoint’i sabit ve float filtrelerini kabul eder ve tek bir istekte her iki türü de döndürebilir. Destek, partner ve çifte bağlıdır. Bazı teklifler, exchange oluşturma sırasında kullanılması gereken kısa ömürlü bir oran kimliği içerir.

Tipik bir API entegrasyonu ne kadar sürer?

Herkese açık pazarlama tahminleri güvenilir bir proje planı değildir. Basit bir proof of concept günler alabilir; üretim zamanlaması ise anahtar onayları, güvenlik incelemesi, arayüz çalışması, uyumluluk durumları, analitik ve destek araçlarına bağlıdır.

_______

Bu karşılaştırma bilgilendirme amaçlıdır. API işlevleri, varlık kapsamı, limitler, ücretler ve uyumluluk gereksinimleri değişebilir. Üretim amaçlı bir kripto para exchange API’si dağıtmadan önce güncel dokümantasyonu ve sözleşme şartlarını inceleyin.