SwapSpace API vs. Changelly API: kompletne porównanie dla deweloperów

Dodanie funkcji swapów do portfela lub produktu Web3 wpływa na znacznie więcej niż tylko na doświadczenie użytkownika. Wybrane API decyduje o tym, jak backend pobiera wyceny, obsługuje wygasłe kursy, śledzi transakcje i reaguje, gdy trasa jest niedostępna. Kształtuje też obciążenie zespołu wsparcia, gdy wymiana jest opóźniona, zwrócona lub wstrzymana do weryfikacji.

To porównanie Changelly API vs SwapSpace API analizuje techniczne różnice istotne dla deweloperów budujących portfele, giełdy i inne produkty Web3.

Porównanie wykorzystuje publiczną dokumentację każdego dostawcy oraz aktualną stronę B2B. Dostępność aktywów, limity żądań, warunki handlowe i zasady zgodności mogą się zmieniać. Potwierdź je w działającym API oraz w umowie partnerskiej przed uruchomieniem.

Czym jest Changelly API?

Changelly API v2 to white-label API giełdy kryptowalut, które udostępnia jedną usługę wycen i transakcji Changelly.

• Protokół: JSON-RPC 2.0 przez podpisane żądania POST.
• Uwierzytelnianie: X-Api-Key oraz podpis RSA-SHA256, z kontem partnerskim i rejestracją klucza publicznego.
• Modele kursu: oddzielne metody dla kursu stałego i zmiennego.
• Pokrycie aktywów: ponad 1 000 aktywów na publicznej stronie B2B, przy czym zestaw aktywów aktywnych na żywo jest zwracany przez API.
• Produkty powiązane: oddzielne usługi API fiat, widget i checkout.

API utrzymuje wybór dostawcy poza aplikacją. Wycenienia stałe i zmienne używają różnych metod, a wyceny stałe mają krótki okres ważności. Te różnice przechodzą razem z transakcją do etapu tworzenia. Główna różnica implementacyjna to podpisywanie żądań, a nie ranking tras.

Czym jest SwapSpace API?

SwapSpace API v2 to REST API, które udostępnia oferty wielu partnerów wymiany przez jedną integrację.

• Protokół: wyspecjalizowane endpointy REST dla walut, partnerów, kwot, tworzenia wymiany i statusu.
• Uwierzytelnianie: klucz API w nagłówku Authorization, z limitami żądań konfigurowanymi dla każdego partnera afiliacyjnego.
• Modele kursu: oferty z kursem stałym i zmiennym, filtry partnerów oraz opcja Best Amount.
• Pokrycie aktywów: ponad 3 600 aktywów w 675 sieciach i ponad 40 źródeł płynności na publicznej stronie B2B, z wymaganą walidacją trasy na żywo.
• Produkty powiązane: widget wymiany i przelewy prywatne, przy czym dostęp do przelewów prywatnych jest potwierdzany osobno.

Każda oferta zawiera dane partnera i trasy. Aplikacja może pokazywać kilka ofert, filtrować je albo korzystać z prostszej metody wyboru. Identyfikatory ofert mogą być krótkotrwałe, a metadane dostawcy mogą zmieniać wymagania dotyczące adresu zwrotu. Te dane na poziomie trasy stanowią główną różnicę architektoniczną względem modelu jednej usługi w Changelly.

Changelly API vs SwapSpace API w skrócie

To porównanie API giełdowe koncentruje się na warstwie integracji, którą deweloper może zweryfikować w publicznej dokumentacji.

Architektura płynności: API pojedynczego dostawcy vs agregator

Wybór wyceny i przejrzystość

Changelly może czerpać płynność z własnej infrastruktury, ale API partnerskie udostępnia Changelly jako granicę usługi. Twoja aplikacja prosi o wycenę i otrzymuje jeden wynik dla żądanej metody i pary. To utrzymuje model wyceny w zwartej formie. Produkt nie musi rankować dostawców ani tłumaczyć, dlaczego dwaj dostawcy zwrócili różne limity.

SwapSpace bezpośrednio udostępnia agregację płynności. Endpoint amounts może zwracać oferty od wszystkich dostępnych partnerów lub z wybranej listy partnerów. Odpowiedź może zawierać trasy stałe i zmienne dla tej samej pary. Daje to portfelowi lub giełdzie większą kontrolę nad sortowaniem. Produkt może sortować według kwoty docelowej, szacowanego czasu, polityki dostawcy lub własnych reguł biznesowych.

Jeśli odbiorcy zależy na wyborze dostawcy lub przejrzystości trasy, integracja ze SwapSpace może pokazywać kilka ofert i stosować zasady wyboru specyficzne dla produktu. Prostszy produkt może udostępnić jedną wybraną trasę. Tożsamość dostawcy, typ kursu, limity i oczekiwany czas pozostają dostępne, gdy interfejs ich potrzebuje.

Dostępność i zachowanie awaryjne

W przypadku Changelly, jeśli waluta jest wyłączona albo wycena się nie powiedzie, API nie udostępnia innego nazwanego dostawcy w ramach tego samego kontraktu. Aplikacja potrzebuje osobnej integracji, aby wybrać inną trasę.

Przed utworzeniem wymiany, SwapSpace może zwrócić oferty od innych dostępnych partnerów. Po utworzeniu wymiany wybrany dostawca pozostaje przypisany do tej transakcji. Changelly koncentruje więc zależność od trasy w jednej usłudze. SwapSpace udostępnia fallback przed transakcją w ramach tego samego API.

Granice zgodności i wsparcia

Oba API mogą udostępniać stany związane z weryfikacją, ale odpowiedzialność jest rozdzielona inaczej. 

Changelly dokumentuje status hold i kieruje partnera do przekazania użytkowników do swojego zespołu bezpieczeństwa. 

SwapSpace udostępnia status Verifying, podczas gdy wybrany dostawca wymiany może kontrolować kontrole. Tożsamość dostawcy i instrukcje wsparcia mają więc większe znaczenie w modelu agregowanym.

Doświadczenie deweloperskie

Dostęp i uwierzytelnianie

Uwierzytelnianie to najbardziej oczywista różnica implementacyjna i kształtuje pierwszy etap integracji swapu krypto.

Changelly:

• Konto partnerskie i rejestracja klucza publicznego.
• Podpis RSA-SHA256 dla każdej treści żądania JSON-RPC.
• Integracja po stronie serwera w celu ochrony klucza prywatnego.

SwapSpace:

• Konto afiliacyjne i klucz API w nagłówku Authorization.
• Limity żądań konfigurowane dla afilianta podczas onboardingu.
• Przechowywanie klucza API po stronie serwera.

Changelly wymaga większej konfiguracji i kodu do podpisywania. SwapSpace używa lżejszego modelu poświadczeń, a wydajność produkcyjna zależy od konfiguracji afilianta.

Dokumentacja i obsługa błędów

Dokumentacja Changelly:

• Schematy żądań na poziomie metod i przykłady błędów.
• Przykłady uwierzytelniania w kilku językach programowania.
• Notatki migracyjne i szczegółowe odniesienie do statusów.

Dokumentacja SwapSpace:

• Krótki przepływ REST od walut i partnerów do statusu wymiany.
• Reguły walidacji dla kwot, identyfikatorów kursu, dodatkowych identyfikatorów, IP użytkownika i warunkowych adresów zwrotu.

Changelly zapewnia bardziej rozbudowane materiały o uwierzytelnianiu i błędach. SwapSpace dokumentuje krótszy przepływ z większą ilością danych do wyboru trasy.

Odpowiedzi JSON-RPC w Changelly ujawniają kody i komunikaty specyficzne dla metod. Przepływ REST w SwapSpace dokumentuje pola walidacyjne, takie jak identyfikatory sieci, identyfikatory kursu, dodatkowe identyfikatory, IP użytkownika i warunkowe adresy zwrotu. Zmapuj te błędy po stronie upstream do stabilnych kategorii wewnętrznych, zanim trafią do interfejsu. Zachowaj oryginalny kod błędu i identyfikator wymiany w logach, aby wsparcie mogło prześledzić trasę bez pokazywania użytkownikowi surowych komunikatów dostawcy.

Wydajność i skalowalność

Changelly publikuje domyślny limit 10 żądań na sekundę dla odpowiednich metod. Publiczne źródła nie określają wyższych progów przepustowości.

SwapSpace nie publikuje standardowego limitu liczbowego, ponieważ limity żądań są konfigurowane dla każdego partnera afiliacyjnego. Planowanie pojemności zależy więc od uzgodnionej konfiguracji partnera, a nie od publicznego domyślnego limitu.

Oba publiczne przepływy udostępniają endpointy statusowe oparte na odpytywaniu. Przeglądane publiczne materiały dla tego porównania nie definiują ogólnego kontraktu webhooków, więc dostępność webhooków pozostaje częścią onboardingu partnera.

Zachowanie oparte na polling również wpływa na planowanie pojemności. Cache’uj metadane walut i partnerów przez określony czas, unikaj odświeżania wycen, których użytkownik nie może już wykorzystać, i zmniejszaj częstotliwość sprawdzania statusu po opuszczeniu przez transakcję etapów wrażliwych czasowo. Testy obciążeniowe powinny obejmować skoki wycen, wygasłe identyfikatory, wyłączone pary i błędy po stronie dostawcy. Mierz cały przebieg błędu, a nie tylko pojedynczą wartość opóźnienia: produkt powinien pozostać responsywny, gdy trasy znikają lub odpowiedzi upstream zwalniają.

Wsparcie i eskalacja

W przypadku API giełdy krypto dla deweloperów, zakres wsparcia ma największe znaczenie, gdy transakcja utknie lub wejdzie w weryfikację. 

Changelly kieruje pytania techniczne na e-mail partnera lub do dedykowanego opiekuna konta. Dokumentacja opisuje model eskalacji, w którym partner zapewnia wsparcie pierwszej linii i przekazuje nierozwiązane sprawy do zespołu drugiego poziomu Changelly przez dedykowany kanał Slack.

SwapSpace udostępnia e-mail partnera i formularz kontaktowy B2B, a także całodobowe wsparcie użytkowników 24/7. Ścieżki eskalacji i zobowiązania dotyczące czasu odpowiedzi zależą od umowy partnerskiej.

Przed integracją któregokolwiek API potwierdź godziny wsparcia, powiadomienia o incydentach, dostęp do strony statusu oraz dane potrzebne do zbadania zablokowanej wymiany.

Warunki handlowe i model przychodów

Żadne API giełdy krypto nie pobiera publicznej opłaty za integrację. Oba wspierają monetyzację partnerów poprzez dodatkową opłatę lub model revenue-sharing.

Changelly pozwala partnerom API dodać opłatę do kursu wymiany. Jej FAQ biznesowe opisuje 0,1% do 5% jako typowy zakres, natomiast aktualna dokumentacja API mówi, że opłata jest konfigurowana przez zespół partnerski.

Punkt końcowy tworzenia wymiany w SwapSpace zawiera opcjonalny parametr affiliateFee. Stawka opłaty afiliacyjnej zależy od wybranego dostawcy płynności i umowy partnerskiej.

Przepływ integracji

Poniższe kroki porównują oba przepływy API do swapu krypto oraz pracę inżynieryjną wymaganą przez każdą integrację z API krypto.

Typowa integracja Changelly

1. 1. Utwórz konto partnerskie Changelly i wygeneruj klucze publiczny oraz prywatny.
2. 2. Zarejestruj klucz publiczny w Changelly i przechowuj klucz prywatny w serwerowym magazynie sekretów.
3. 3. Zaimplementuj serializację żądań JSON-RPC 2.0 i podpisywanie RSA-SHA256.
4. 4. Pobierz dane o aktywnych walutach i zmapuj tickery, sieci, pola memo oraz reguły walidacji.
5. 5. Poproś o wycenę zmienną lub stałą, a następnie zweryfikuj zwróconą kwotę i limity.
6. 6. Utwórz właściwy typ transakcji przed wygaśnięciem okna wyceny lub płatności.
7. 7. Zapisz identyfikator transakcji i odpytywanie getStatus lub getTransactions z backoffem.
8. 8. Zmapuj każdy stan końcowy, zwrotu, wygaśnięcia i weryfikacji na komunikat dla użytkownika i procedurę wsparcia.

Changelly nakłada dwa ograniczenia protokołu: podpis musi odpowiadać dokładnie zserializowanej treści, a wyceny v2 muszą pozostać sparowane z metodami transakcji v2.

💡 Ważne! Przepływy stałe i zmienne używają różnych metod, więc należy testować je osobno.

Typowa integracja SwapSpace

1. 1. Utwórz konto afiliacyjne, uzyskaj klucz API i potwierdź przydzielony limit żądań dla docelowego środowiska.
2. 2. Pobierz listę walut i zachowaj osobne identyfikatory aktywów i sieci.
3. 3. Pobierz listę partnerów i zapisz wymagania trasy, takie jak reguły adresu zwrotu.
4. 4. Poproś o dostępne kwoty dla pary, kwoty, sieci i wymaganych typów kursu.
5. 5. Uszereguj zwrócone oferty lub użyj endpointu Best Amount zgodnie z polityką wyboru produktu.
6. 6. Zweryfikuj wartości minimalne i maksymalne, a następnie utwórz wymianę przed wygaśnięciem zwróconego identyfikatora kursu.
7. 7. Zapisz identyfikator wymiany SwapSpace, wybranego dostawcę i dane transakcyjne widoczne dla użytkownika.
8. 8. Odpytywanie endpointu statusu z backoffem i obsługa stanów finished, failed, refunded, verifying i expired.

SwapSpace wiąże wybraną ofertę z utworzoną wymianą. Nowa wycena lub nowy dostawca tworzy nowe żądanie wymiany.

💡 Ważne! Jeśli wycena wygaśnie przed utworzeniem wymiany, użytkownik powinien zatwierdzić zaktualizowaną ofertę.

Które API pasuje do różnych produktów?

Zespoły oceniające API krypto dla portfela powinny najpierw zdecydować, czy użytkownicy potrzebują jednej relacji wymiany, czy widocznego wyboru dostawcy.

Tabela traktuje dopasowanie produktu jako hipotezę wyjściową. Warunki handlowe, regiony, popyt na aktywa, ruch i wewnętrzne możliwości inżynieryjne mogą zmienić wynik.

Kiedy Changelly API ma sens

Changelly API pasuje do produktów, które preferują jedną usługę wymiany i zwięzłą odpowiedź z wyceną.

Szczegółowe przykłady podpisywania i dokumentacja błędów na poziomie metod pomagają zespołom, które cenią jasno określoną warstwę uwierzytelniania. Może też odpowiadać firmom, które planują ocenić oddzielne produkty fiat lub checkout Changelly w ramach tej samej relacji B2B.

Kompromis to widoczność trasy. API zwraca wycenę Changelly, a nie listę nazwanych dostawców wymiany. Integracja wymaga też rejestracji klucza publicznego podczas onboardingu.

Kiedy SwapSpace API ma sens

SwapSpace jest lepszym wyborem, gdy porównywanie dostawców jest częścią produktu. Udostępnia wiele ofert, opcje stałe i zmienne, filtry partnerów oraz metadane tras przez jedno REST API. Jego strona B2B wymienia ponad 40 źródeł płynności i 3 600+ aktywów w 675 sieciach. Wartością jest szersze pokrycie długiego ogona i tras międzyłańcuchowych w ramach jednego kontraktu.

Jeśli produkt pobiera wiele ofert i sam wybiera trasę, integracja może wymagać wyraźnych kryteriów wyboru, obsługi wygaśnięcia wyceny i danych wymiany specyficznych dla dostawcy. Produkty korzystające z Best Amount lub prostszego przepływu mogą utrzymać większą część tej logiki routingu poza interfejsem użytkownika.

Ostateczny werdykt

Nie istnieje uniwersalne najlepsze API swapów. 

Changelly używa JSON-RPC 2.0, podpisywania żądań RSA-SHA256 i modelu wyceny z jednym dostawcą. Oferuje szczegółową dokumentację metod i błędów, ale nie udostępnia konkurencyjnych tras dostawców w ramach tego samego API. 

SwapSpace używa REST z uwierzytelnianiem kluczem API i zwraca oferty od wielu partnerów wymiany, dając produktom większą kontrolę nad wyborem trasy oraz szersze pokrycie aktywów.

Wybierz Changelly dla produktów, które preferują relację z jednym dostawcą, zwięzły przepływ wyceny i szczegółową dokumentację na poziomie metod. Wybierz SwapSpace dla portfeli, giełd i produktów Web3, które potrzebują porównywania dostawców, agregacji płynności lub szerszego pokrycia tras długiego ogona.

Rozpocznij integrację z SwapSpace API

Wyślij formularz na stronie B2B SwapSpace, aby omówić dostęp, limity żądań i wymagania integracyjne z zespołami produktu i business development. 

Często zadawane pytania

Jaka jest różnica między SwapSpace API a Changelly API?

Changelly udostępnia white-label usługę wymiany przez JSON-RPC 2.0. Aplikacja otrzymuje wyceny Changelly i tworzy transakcje Changelly. SwapSpace udostępnia wiele ofert partnerów przez REST API, umożliwiając aplikacji porównanie lub filtrowanie tras przed utworzeniem wymiany.

Czy SwapSpace API agreguje wielu dostawców płynności?

Tak. Endpoint amounts może zwracać oferty od wszystkich dostępnych partnerów lub filtrować według wybranych partnerów. Publiczna strona B2B wymienia ponad 40 źródeł płynności. Dostępność zależy od aktywa, sieci, kwoty, typu kursu i aktualnych warunków dostawcy.

Które API jest lepsze dla portfeli krypto?

To zależy od projektu produktu portfela. Changelly pasuje do portfela, który chce jednej wyceny i jednej relacji z dostawcą. SwapSpace pasuje do portfela, który chce porównywania dostawców, szerszego pokrycia tras lub własnej logiki rankowania ofert. Przydatność zależy też od pokrycia typowych par portfela oraz par z długiego ogona.

Czy mogę zintegrować swapy krypto bez budowania własnej giełdy?

Tak. Oba API pozwalają produktowi zlecić realizację wymiany na zewnątrz, zachowując kontrolę nad interfejsem i orkiestracją backendu. Walidacja adresów, obsługa statusów i wsparcie pozostają częścią integracji produktu.

Czy SwapSpace API obsługuje kursy stałe i zmienne?

Tak. Endpoint amounts przyjmuje filtry fixed i float i może zwrócić oba typy w jednym żądaniu. Obsługa zależy od partnera i pary. Niektóre oferty zawierają krótkotrwały identyfikator kursu, który trzeba użyć podczas tworzenia wymiany.

Ile zwykle trwa integracja API?

Publiczne szacunki marketingowe nie są wiarygodnym planem projektu. Podstawowy proof of concept może zająć dni, natomiast czas wdrożenia produkcyjnego zależy od zatwierdzeń kluczy, przeglądu bezpieczeństwa, prac nad interfejsem, stanów zgodności, analityki i narzędzi wsparcia.

_______

To porównanie ma charakter informacyjny. Funkcje API, pokrycie aktywów, limity, opłaty i wymagania zgodności mogą się zmieniać. Przed wdrożeniem produkcyjnego API giełdy kryptowalut przejrzyj aktualną dokumentację i warunki umowne.