チュートリアル

Webhookメッセージの受信と処理

 

Webhookを使用すると、取引ボットで何か発生したときに通知を受け取ることができます。このチュートリアルでは、Webhookを検証し、APIのWebhookメッセージの受信と処理を開始する方法を学びます。このチュートリアルでは、PHP言語を使用してWebhookを作成しますが、もちろん、他の任意のプログラミング言語でもWebhookを作成できます。Webhookメッセージを送信できるパブリックサーバーが明らかに必要であり、パブリックサーバーはSSL証明書で保護されている必要があり、httpsを介してアクセスできる必要があります。また、Cryptohopperでアプリも必要です。まだアプリを作成していない場合は、Appsに移動して、最初のアプリを作成してください。

Webhookの準備

Webhookを構成してアプリに接続する前に、サーバーでWebhookを準備します。以下のPHPコードをコピーして、サーバーのパブリックフォルダーに配置します。webhook.phpと名付けましょう。


アプリシークレット変数と検証コード変数を必ず調整してください。アプリシークレットはアプリを編集すると見つけることができます。検証コードは何でもかまいません。検証コードを覚えておくようにしてください。Webhookを検証するときに必要になるためです。

アプリでのWebhookの構成

サーバーでWebhookを作成したので、アプリでWebhookを構成できます。Appsに移動し、アプリを選択して、「Webhook」タブをクリックします。「Webhookを追加」をクリックして、Webhook URL(https付き)の入力を開始します。次に、サブスクリプションを選択して、受信するメッセージの種類を構成できます。最後に、サーバーのPHPコードに入力した検証コードを入力する必要があります。これは完全に一致する必要があります。検証して保存をクリックすると、Webhookが接続されたWebhookのリストの下に表示されるはずです。

Webhookメッセージの受信

例のPHPコードはWebhookメッセージをエコーして印刷するように設計されているため、Webhookコードが機能しているかどうかをすぐには確認できません。したがって、Webhookメッセージを電子メールに転送したり、たとえばデータベースにメッセージを保存したりするために、PHPコードをいくつか調整する必要があります。決定はあなた次第であり、Webhookメッセージをどのようにしたいのかはあなた次第です。

Webhookメッセージを単に通知としてメールに転送するには、次の例のPHPコードを使用し、調整することができます。

'.$message['type'];
            $email_message .= 'タイトル:
'.$message['title']; $email_message .= '

'; $email_message .= 'メッセージ:
'.$message['message']; mail($send_to_email, $subject_email, $email_message); } } }else{ // unkown type echo '不明なWebhookメッセージタイプ。'; } }else{ //invalid signature echo '無効な署名。'; } ?>

上記の例の変数をニーズに合わせて必ず編集してください。Webhookの可能性に関する詳細情報が必要な場合は、詳細についてはWebhooks APIドキュメントを確認してください。