Met een webhook kun je notificaties ontvangen wanneer er iets gebeurt met een trading bot. In deze tutorial leer je hoe je je webhook kunt verifiëren en hoe je webhook-berichten van de API kunt ontvangen en verwerken. In deze tutorial gebruiken we de PHP-taal om onze webhook te maken, maar je kunt je webhook uiteraard ook in elke andere programmeertaal bouwen. Je hebt duidelijk een publieke server nodig waar we de webhook-berichten naartoe kunnen sturen, en de publieke server moet worden beveiligd met een SSL-certificaat, deze moet bereikbaar zijn via https. Je hebt ook een app op Cryptohopper nodig, als je nog geen app hebt gemaakt, ga dan naar Apps en maak je eerste app.

Je webhook voorbereiden

Voordat we je webhook configureren en verbinden met je app, bereiden we je webhook voor op je server. Kopieer de PHP-code hieronder en plaats deze in de publieke map van je server. Laten we het webhook.php noemen.

Zorg ervoor dat je de geheime variabele van de app en de verificatiecode-variabele aanpast. De geheime app-code kun je vinden wanneer je je app bewerkt, en de verificatiecode kan alles zijn wat je wilt. Zorg er gewoon voor dat je de verificatiecode onthoudt, want die heb je nodig wanneer je je webhook wilt verifiëren.

Configureer je webhook in je app

Nu je een ​​webhook op je server hebt gemaakt, kunnen we je webhook configureren in je app. Ga naar Apps, selecteer je app en klik op het tabblad "webhook". Klik op "Webhook toevoegen" en begin met het invoeren van je webhook-URL (met https). Vervolgens kun je configureren welk type berichten je wilt ontvangen door abonnementen te selecteren. Ten slotte moet je de verificatiecode invoeren die je in de PHP-code op je server hebt ingevoerd, deze moet exact overeenkomen. Klik op valideren en opslaan, je webhook zou nu hieronder in de lijst met verbonden webhooks moeten verschijnen.

Webhook-berichten ontvangen

Omdat de PHP-code in het voorbeeld zo is ontworpen dat deze alleen de webhook-berichten weergeeft en afdrukt, zie je niet meteen of je webhook-code werkt. Daarom moeten we een paar aanpassingen aan de PHP-code aanbrengen om de webhook-berichten door te sturen naar e-mail of bijvoorbeeld berichten op te slaan in een database. De beslissing is aan jou, het is aan jou wat je met de webhook-berichten wilt doen.

Om de webhook-berichten eenvoudigweg als meldingen door te sturen naar je e-mail, kun je de PHP-code in het volgende voorbeeld gebruiken en aanpassen.

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

';
            $email_message .= 'Bericht:
'.$message['message'];
                
            mail($send_to_email, $subject_email, $email_message);
            }
        }
}else{
// unkown type
echo 'Onbekend webhook bericht type.';
}
}else{
//invalid signature
echo 'Ongeldige handtekening.';
}
?>

Zorg ervoor dat je de variabelen in het bovenstaande voorbeeld bewerkt om aan je behoeften te voldoen. Als je meer informatie nodig hebt over de mogelijkheden van webhooks, lees dan de Webhooks API-documentatie voor meer informatie.