Czym jest WhiteBIT API?

WhiteBIT API to narzędzie automatyzacji, które umożliwia programistom tworzenie aplikacji do interakcji z naszą giełdą. Dzięki niemu można m.in.: tworzyć i zarządzać zleceniami kupna i sprzedaży kryptowalut, uzyskiwać informacje o rynku, sprawdzać saldo konta i wiele więcej.

Jak korzystać z WhiteBIT API?

Przed rozpoczęciem korzystania z API, należy włączyć dwuetapową weryfikację (2FA) na swoim koncie. 

Następnie trzeba wygenerować klucze API, które służą do uwierzytelnienia użytkownika i integracji z API.

Aby aktywować klucze, wykonaj następujące kroki:

• Przejdź do ustawień API na swoim koncie i wybierz “Edytuj” w odpowiedniej sekcji.
• Po kliknięciu “Wygeneruj klucz API”, wprowadź swój kod 2FA.
• W oknie, które się pojawi, zobaczysz parę kluczy API – zachowaj je, ponieważ będą one potrzebne do dalszej autoryzacji operacji w interfejsie API.

Upewnij się, że bezpiecznie przechowujesz swój Klucz Tajny, ponieważ po zamknięciu tej strony nie będzie można go przywrócić. Klucz Publiczny jest zawsze dostępny i nie stanowi zagrożenia podczas przekazywania go stronom trzecim. W przeciwieństwie do Klucza Tajnego, Klucz Publiczny sam w sobie nie stwarza ryzyka niepożądanych działań.

• Na tej samej stronie możesz również wybrać końcowe punkty API (endpoint), które zamierzasz używać. Zaleca się wybranie wszystkich dostępnych punktów podczas testowania kluczy API, ponieważ później można to edytować. Bardziej szczegółowe informacje na temat endpointów zostaną przedstawione dalej w artykule.
• Następnie potwierdź swoje działania, wprowadzając kod 2FA;
• I oto, twoje klucze API są gotowe do użycia!

Po utworzeniu pary kluczy API można również zmienić dostęp IP. Dzięki funkcji ograniczenia dostępu za pomocą adresów IP, można dodać własne adresy IPv4 i IPv6 do listy zaufanych adresów IP.

W przypadku aktywacji tej funkcji, jeśli żądanie otrzymania kluczy API zostanie wysłane z innego adresu IP, klucze API zostaną automatycznie dezaktywowane. Na adres e-mail zostanie wysłane powiadomienie z informacją o publicznym kluczu i adresie IP, z którego zostało wysłane żądanie.

Jeśli ten adres IP należy do сiebie i jest zaufany, możesz ponownie aktywować API, dodając go do listy zaufanych adresów IP.

Ogólnie rzecz biorąc, można dodać do listy zaufanych maksymalnie 20 adresów IP.

Wracając do listy dostępnych punktów końcowych (endpoint) do wykorzystania, warto zauważyć, że każda z przedstawionych kategorii i podkategorii odpowiada za określoną grupę operacji do zarządzania kontem na giełdzie. Możesz tworzyć i używać swoich kluczy do wykonywania operacji w jednej lub kilku z następujących dostępnych kategorii:

• Depozyty
• Wypłaty
• Przelewy między saldami
• Saldo i historia portfela
• Kody
• Saldo handlowe i historia
• Zarządzanie zleceniami

Szczegółowe informacje na temat funkcjonalności API naszej giełdy można znaleźć w instrukcji technicznej, przedstawionej w prostym i dostępnym formacie.

Rozszerzona dokumentacja jest również dostępna w ogólnodostępnym repozytorium oprogramowania na GitHubie.

Aby przetestować funkcjonalność naszego API, możesz również skorzystać z tokenów DEMO.

WhiteBIT Webhook

Webhook jest używany do otrzymywania informacji zwrotnych od serwera na temat wykonania różnych procesów na twoim koncie, takich jak pomyślne wypłacenie środków lub aktywacja kodu WB.

Aby aktywować klucze Webhook, należy wykonać te same kroki co w przypadku kluczy API w sekcji ustawień Webhook na twoim koncie. Istnieje kilka sposobów aktywacji:

• Dodanie publicznego klucza do rekordu domeny TXT, wskazanego podczas tworzenia klucza;
• Dodanie pliku "whiteBIT-verification.txt" z treścią twojego publicznego klucza Webhook do głównego katalogu twojej strony internetowej;
• Utworzenie punktu końcowego „check-wb-webhooks” na twoim serwerze, który zwróci publiczny klucz Webhook.

Aby rozpocząć aktywację klucza Webhook, musisz go najpierw utworzyć na giełdzie. Należy pamiętać, że można utworzyć tylko jeden klucz Webhook. Aby to zrobić, wykonaj następujące kroki:

• Przejdź do sekcji ustawień Webhook na swoim koncie i wybierz “Edytuj” w odpowiedniej sekcji;
• Tak jak w przypadku tworzenia kluczy API, zapisz klucz tajny (Secret Key) w bezpiecznym miejscu. Po zamknięciu strony przyciskiem “Potwierdź”, klucz tajny nie będzie już dostępny;
• Gotowe! Klucz Webhook został utworzony.

Należy pamiętać, że tak jak w przypadku kluczy API, utworzenie klucza Webhook nie aktywuje go automatycznie. Należy przesunąć suwak w aktywną pozycję, aby aktywować Webhook.

Szczegółowe informacje na temat ustawień i korzystania z Webhook są dostępne w odpowiedniej sekcji naszej dokumentacji Webhook.

Najczęściej zadawane pytania

Co się stanie z kluczami API i Webhook w przypadku wyłączenia dwuskładnikowego uwierzytelniania 2FA?

• W przypadku wyłączenia 2FA, twoje klucze API i Webhook zostaną wyłączone i można je będzie ponownie aktywować dopiero po włączeniu 2FA.

Czy można tworzyć i aktywować klucze API oraz Webhook przez aplikację mobilną WhiteBIT?

• Niestety, nie. Proces tworzenia i aktywacji kluczy jest dostępny wyłącznie w wersji internetowej naszej giełdy.

Czy klucze API mają termin ważności i ile można ich utworzyć?

• Jeśli klucz API pozostanie nieaktywny przez 14 dni, zostanie automatycznie dezaktywowany w celu utrzymania bezpieczeństwa. Maksymalna liczba kluczy wynosi 50.

Czy można użyć dowolnej domeny do testowania kluczy Webhook?

• Nasz system nie przewiduje takich działań. Aby aktywować klucz Webhook, konieczne jest potwierdzenie prawa własności do domeny.

Wsparcie

Jeśli masz jakiekolwiek pytania dotyczące funkcjonalności naszej giełdy, możesz:

• Wysłać zgłoszenie na naszej stronie internetowej;
• Napisać na e-mail obsługi klienta: support@whitebit.com;
• Napisać w czat, używając przycisku w prawym dolnym rogu ekranu (w aplikacji WhiteBIT, w prawym górnym rogu, nacisnąć ).