はじめに
DomoのJSON Webhookコネクターを使用すると、IFTTT、Github、Fitbitなど、JSONフォーマットデータをプッシュするデータソースに接続できます。JSON Webhookを活用すると、気象観測機、自動販売機、ウェアラブル端末などからのデータにリアルタイムでアクセスできます。Webhookのリンクには有効期限が長いワンタイムトークンが含まれており、このリンクを知っている人なら誰でもDataSetにデータを公開できます。 JSON Webhook接続を設定するには、以下で説明するように、Data Centerとサードパーティアプリケーションでオプションを設定します。 ビデオ - JSON Webhook DataSetを作成するJSON Webhook接続を設定する
このセクションでは、DomoとサードパーティアプリケーションでJSON Webhook接続を設定する方法について説明します。接続を適切に設定すれば、いつでも同じアカウントを使用して新しいJSON Webhook DataSetを作成できるようになります。コネクターアカウントは、Data Centerの [アカウント] タブで管理できます。このタブの詳細については、「 コネクターのユーザーアカウントを管理する 」を参照してください。 JSON Webhook接続を設定するには:- 画面上部のナビゲーションペインで [AppStore] を選択します。
- 「JSON Webhook」を検索し、表示されたタイトルをクリックします。
- [Get the Data] をクリックします。
- [リンクをコピー] をクリックします。
-
コピーしたリンクをサードパーティアプリケーションの適切な場所に貼り付けます。
次のスクリーンショットはGithubのものです。
上のスクリーンショットのように、この場所は 通常 、「ペイロードURL」のような名前のフィールドになります。ただし、例外もあります。よく分からない場合は、サードパーティアプリケーションのドキュメントを参照してください。 また、URLを貼り付ける際には、必ずサードパーティアプリケーションの要件に従ってください。一部のアプリケーションでは、トークン(最後のバックスラッシュの後の部分)を別の行に貼り付ける必要があります。

-
また、サードパーティアプリケーションでは、必ずコンテンツタイプを「application/json」に設定してください。

- 必要に応じて、サードパーティアプリケーションでほかの設定を行い、Webhookを保存します。
- DomoのJSON Webhookコネクターインターフェースに戻ります。
- (オプション)必要に応じて、 Webhookシークレット を入力します。 Webhookシークレットが指定されている場合、Domoはすべての投稿でX-Hub-Signatureヘッダーが使用されていると想定します。X-Hub-Signatureの値は、WebhookシークレットとSHA1、SHA256、SHA512ハッシュアルゴリズムのいずれかを使用した、要求本文のHMAC(ハッシュベースのメッセージ認証コード)です。
- (オプション)IPやタイムスタンプなどのメタデータをDataSetに含める場合は、 [詳細] ビューの最後のメニューで [はい] をクリックします。そうでない場合は、 [いいえ] のままにしておきます。
- (オプション)DataSetが更新されたときに「追加」ではなく「置換」を使用する場合は、 [更新設定を変更] をクリックし、メニューで [置き換え] を選択して、 [保存] をクリックします。
- [Next] をクリックします。
- DataSetの名前と説明(オプション)を該当するフィールドに入力します。
- [保存] をクリックします。
よくある質問
このコネクターにプッシュする必要があるデータのタイプは何ですか?
このコネクターにプッシュする必要があるデータのタイプは何ですか?
JSONフォーマットデータです。
データに空のフィールドが含まれている場合、どのように解釈すればよいですか?
データに空のフィールドが含まれている場合、どのように解釈すればよいですか?
コネクターは行ごとにレコードを作成するため、行にデータが含まれていない場合は、DataSetに空の行が表示されます。
私のWebhook DataSetにデータをプッシュできるのは誰ですか?
私のWebhook DataSetにデータをプッシュできるのは誰ですか?
Webhookのリンクには有効期限が長いワンタイムトークンが含まれており、このリンクを知っている人なら誰でもDataSetにデータを公開できます。
ほかのユーザーがWebhookリンクを使用して私のDataSetを表示できますか?
ほかのユーザーがWebhookリンクを使用して私のDataSetを表示できますか?
Webhookリンクはデータをプッシュしますが、データを表示または公開することはありません。
このコネクターにはレート制限がありますか?
このコネクターにはレート制限がありますか?
1秒あたり25コールのレート制限があります。
単一コールのサイズ制限はありますか?
単一コールのサイズ制限はありますか?
あります。Webhookは、1回の呼び出しで最大100KBのデータを受け付けます。