S webhookem můžeš dostávat notifikace, když se něco děje s obchodním botem. V tomto návodu se dozvíš, jak ověřit svůj webhook a začít přijímat a zpracovávat zprávy webhooku z API. V tomto návodu použijeme jazyk PHP k vytvoření našeho webhooku, ale samozřejmě budeš moci vytvořit svůj webhook i v jakémkoli jiném programovacím jazyce. Je jasné, že budeš potřebovat veřejný server, kam můžeme posílat zprávy webhooku, a veřejný server musí být zabezpečen certifikátem SSL, musí být přístupný přes https. Budeš také potřebovat aplikaci na Cryptohopperu, pokud jsi ještě nevytvořil aplikaci, přejdi na Apps a vytvoř si svou první aplikaci.

Příprava tvého webhooku

Než nakonfigurujeme a připojíme tvůj webhook k tvé aplikaci, připravíme tvůj webhook na tvém serveru. Zkopíruj níže uvedený kód PHP a vlož ho do veřejné složky tvého serveru. Pojmenujme jej webhook.php.

Nezapomeň upravit proměnnou secret app a proměnnou ověřovacího kódu. Secret app najdeš při úpravě své aplikace a ověřovací kód může být cokoli, co chceš. Jen si pamatuj ověřovací kód, protože ho budeš potřebovat, až budeš chtít ověřit svůj webhook.

Konfigurace tvého webhooku v tvé aplikaci

Nyní, když jsi vytvořil webhook na svém serveru, můžeme nakonfigurovat tvůj webhook v tvé aplikaci. Přejdi na Apps, vyber si svou aplikaci a klikni na záložku "webhook". Klikni na "Přidat webhook" a začni zadávat URL svého webhooku (s https). Dále můžeš nakonfigurovat, jaký typ zpráv chceš dostávat, výběrem odběrů. Nakonec musíš zadat ověřovací kód, který jsi zadal v kódu PHP na svém serveru, musí se přesně shodovat. Klikni na ověřit a uložit, tvůj webhook by se měl nyní zobrazit níže v seznamu připojených webhooků.

Příjem zpráv webhooku

Protože kód PHP v příkladu je navržen tak, aby pouze echo a tisk zpráv webhooku, neuvidíš okamžitě, jestli tvůj kód webhooku funguje. Proto musíme provést nějaké úpravy v kódu PHP, abychom přeposlali zprávy webhooku na e-mail nebo například uložili zprávy do databáze. Rozhodnutí je na tobě, je na tobě, co chceš se zprávami webhooku dělat.

Aby ses zprávy webhooku jednoduše přeposlaly jako oznámení na tvůj e-mail, můžeš použít a upravit kód PHP v následujícím příkladu.

'.$message['type'];
            $email_message .= 'Název:
'.$message['title'];
            $email_message .= '

';
            $email_message .= 'Zpráva:
'.$message['message'];
                
            mail($send_to_email, $subject_email, $email_message);
            }
        }
}else{
// unkown type
echo 'Neznámý typ zprávy webhooku.';
}
}else{
//invalid signature
echo 'Neplatný podpis.';
}
?>

Nezapomeň upravit proměnné v uvedeném příkladu tak, aby odpovídaly tvým potřebám. Pokud potřebuješ více informací o možnostech webhooků, podívej se prosím na dokumentaci k API webhooků pro více informací.