Poradniki

Odbieranie i obsługa wiadomości webhook

 

Dzięki webhookowi możesz otrzymywać powiadomienia, gdy coś dzieje się z botem tradingowym. W tym samouczku dowiesz się, jak zweryfikować swój webhook i zacząć odbierać i przetwarzać wiadomości webhook z API. W tym samouczku użyjemy języka PHP do stworzenia naszego webhooka, ale oczywiście możesz również stworzyć swój webhook w dowolnym innym języku programowania. Będziesz potrzebować publicznego serwera, na który będziemy mogli wysyłać wiadomości webhook, a publiczny serwer musi być zabezpieczony certyfikatem SSL, musi być dostępny przez https. Będziesz również potrzebować aplikacji w Cryptohopper, jeśli jeszcze jej nie utworzyłeś, przejdź do Apps i stwórz swoją pierwszą aplikację.

Przygotowywanie webhooka

Zanim skonfigurujemy i połączymy Twój webhook z aplikacją, przygotujemy Twój webhook na Twoim serwerze. Skopiuj poniższy kod PHP i umieść go w publicznym folderze swojego serwera. Nazwijmy to webhook.php.


Pamiętaj, aby dostosować zmienną secret aplikacji i zmienną kodu weryfikacyjnego. Sekret aplikacji możesz znaleźć podczas edycji aplikacji, a kod weryfikacyjny może być dowolny. Po prostu upewnij się, że pamiętasz kod weryfikacyjny, ponieważ będziesz go potrzebować, gdy będziesz chciał zweryfikować swój webhook.

Skonfiguruj swój webhook w swojej aplikacji

Teraz, gdy utworzyłeś webhook na swoim serwerze, możemy skonfigurować Twój webhook w Twojej aplikacji. Przejdź do Apps, wybierz swoją aplikację i kliknij zakładkę "webhook". Kliknij "Dodaj webhook" i zacznij wpisywać swój adres URL webhook (z https). Następnie możesz skonfigurować, jaki typ wiadomości chcesz otrzymywać, wybierając subskrypcje. Na koniec musisz wprowadzić kod weryfikacyjny, który wprowadziłeś w kodzie PHP na swoim serwerze, musi być dokładnie taki sam. Kliknij weryfikuj i zapisz, Twój webhook powinien być teraz widoczny poniżej na liście podłączonych webhooków.

Odbieranie wiadomości webhook

Ponieważ kod PHP w przykładzie jest zaprojektowany tylko do wyświetlania i drukowania wiadomości webhook, nie zobaczysz od razu, czy Twój kod webhook działa. Dlatego musimy wprowadzić kilka poprawek w kodzie PHP, aby przekazywać wiadomości webhook do e-maila lub na przykład zapisywać wiadomości w bazie danych. Decyzja należy do Ciebie, Ty decydujesz, co chcesz zrobić z wiadomościami webhook.

Aby po prostu przekazywać wiadomości webhook jako powiadomienia na swój e-mail, możesz użyć i dostosować kod PHP w poniższym przykładzie.

'.$message['type'];
            $email_message .= 'Tytuł:
'.$message['title']; $email_message .= '

'; $email_message .= 'Wiadomość:
'.$message['message']; mail($send_to_email, $subject_email, $email_message); } } }else{ // unkown type echo 'Nieznany typ wiadomości webhook.'; } }else{ //invalid signature echo 'Nieprawidłowy podpis.'; } ?>

Pamiętaj, aby edytować zmienne w powyższym przykładzie, aby odpowiadały Twoim potrzebom. Jeśli potrzebujesz więcej informacji na temat możliwości webhooków, sprawdź Webhooks API documentation, aby uzyskać więcej informacji.