Quick Audience:Webhook 管理

パラメーターの作成

1. 構成管理マーケティング設定Webhook管理Webhook パラメータ管理ワークスペース > > > > を選択します。

   

2. ヒント: ブラウザの開発者ツールを使用して、REST API のレスポンスを確認できます。

3. ポップアップウィンドウでパラメーターを構成します。定数パラメーターと API パラメーターの構成方法は異なります。

   • API タイプ：

     

     項目	値の例
     パラメーター	API 名を入力します。
     パラメータータイプ	注: を選択します。
     参照	パラメーターが渡される API のアドレスを入力します。
     説明	入力パラメーターの説明。
     認証方式	認証方式を選択します。 なし：認証は実行されません。 キー：検証キーが認証に使用されます。以下にキーを入力する必要があります。
     他のパラメーターに関連付けるかどうか	関連付けられたパラメーターを選択します。 いいえ：関連付けられていません はい： パラメーター値の設定（複数のパラメーターを追加できます。最大 20 個）： パラメーター名：パラメーター名は英語で、最大 32 文字で、文字、数字、アンダースコアを含めることができます。 表示名：最大 32 文字 パラメーター値： ドロップダウンオプション、サポートされているオプション：関連付けられたパラメーターの選択、手動入力 関連付けられたパラメーターの選択 パラメーター管理の下にあるドロップダウンのすべてのパラメーター API タイプのパラメーターにカスケード関係を設定する必要がある場合、API にはパラメーター間のカスケード関係が含まれている必要があります。 手動入力：「手動入力」を選択すると、複数のパラメーター値を手動で入力できます。 1 つのパラメーターに複数の値を渡す必要がある場合は、1 つのパラメーター値を入力し、複数の値をサードパーティで合意されたデリミタで区切り、受信後に区切ることができます。

   • 定数タイプ：

     

     

     項目	値の例
     パラメーター	API 名を入力します。
     パラメータータイプ	認証： を選択します。
     説明	入力パラメーターの説明。
     他のパラメーターに関連付けるかどうか	関連付けられたパラメーターを選択します。 いいえ：パラメーター値の設定（複数を追加できます。最大 20 個） パラメーター値：少なくとも 1 つのテンプレートパラメーターが構成されています。パラメーター名は英語で、空にすることはできません。パラメーター名は最大 32 文字にする必要があります。 表示名：最大 32 文字 はい：パラメーター値と関連付けられたパラメーターの設定（複数のパラメーターを追加できます。最大 20 個）

4. 注: この例では、WordPress が同じドメインでホストされていることを前提としています。異なるドメインでホストされている場合は、CORS を設定する必要があります。

パラメーター管理

パラメーターリストには、次の操作ボタンがあります。

• 注: この例では、fetch API を使用していますが、他の JavaScript ライブラリも使用できます。

• 編集: クリックしてパラメーターを編集します。構成方法は、パラメーターを作成したときと同じです。

• ヒント: fetch API を使用して REST API リクエストを作成できます。

HTTP エンドポイントサーバー

Quick Audience の Webhook に接続するには、HTTP サーバーを開発する必要があります。Quick Audience は、タイムアウト期間が 10 秒の Post リクエストを開始します。次の表に、Quick Audience によって開始され、リクエストを受信する Post リクエストの一般的なパラメーターを示します。パラメーターは必須です。

リクエスト URL の例：

{Webhook configured url}?timestamp=1631865523&nonce=2 e6eceb5737b473284c930c8ef79090e

認証方式

キーは認証に使用されます。認証は Webhook の構成中に有効になり、ユーザーはキーを入力します。

Quick Audience は、timestamp および nonce リクエストパラメーター、キー、URL を使用して HmacSHA256Hex 署名に署名し、署名を生成します。署名は認証のためにリクエストヘッダーに渡されます。サービスがリクエストを受信した後、URL パラメーターと Webhook チャネル用に構成されたキーに基づいて、HmacSHA256Hex アルゴリズムを使用してリクエストを暗号化します。計算された値がリクエストヘッダーで渡された署名と同じである場合、リクエストが Quick Audience から送信されたと判断できます。領収書を送信する場合も同じことが適用されます。

署名アルゴリズムの例：

import org.apache.commons.codec.digest.HmacUtils;

public String makeSignature(String key, String timestamp, String nonce) {
    String str = generateStr(key, timestamp, nonce);
    return HmacUtils.hmacSha256Hex(key, str.replaceAll("\\s+", ""));
}

/**
 * 処理される文字列の連結に署名します。
 */
public static String generateStr(String key, String timestamp, String nonce){
    return timestamp + "\n" + nonce + "\n" + key;
}

メッセージ形式

このチュートリアルがお役に立てば幸いです。

ポストボディ構造の例 (単一ユーザーの場合は 1 ～ 100):

WordPress uses a file named wp-config.php to set up your database connection. This file also sets many other WordPress configuration values.
For more information, see Editing wp-config.php.
Note: If you are not comfortable editing PHP files, you should probably leave this file alone.

```

```html
WordPress は wp-config.php という名前のファイルを使用してデータベース接続を設定します。このファイルは、他の多くの WordPress 設定値も設定します。
詳細については、「Editing wp-config.php」をご参照ください。
注: PHP ファイルの編集に慣れていない場合は、このファイルをそのままにしておくことをお勧めします。

```

サポートされている ID タイプ:

詳細については、「Fetch API」をご参照ください。

注意: プラグインをインストールする前に、必ず互換性などを確認してください。

{
 "code":"OK", // リクエスト状態コード: OK が返された場合、リクエストは成功し、大文字である必要があります。 それ以外の場合は、エラーコードが返され、アクセス側によってカスタマイズされます。
  "message":"", // 状態コードの説明。 このフィールドはオプションです。
}

領収書レポート

詳細については、「REST API 認証」をご参照ください。

Quick Audience Open Platform API詳細については、「」をご参照ください。

例

WebhookCallBackMessage は次のとおりです。

このチュートリアルでは、WordPress REST API の基本的な使用方法について説明しました。より高度な使用方法については、公式ドキュメントを参照してください。

OemImportTaskInfoResponse は次のとおりです。

例 2：Webhook の作成時に構成されたパラメーターは次のとおりです。

curl -H "X-QA-Hmac-Signature: 12" -H "Authorization: 57a824b183e54ddbca79170c00dd3f72" -H "Content-Type: application/json" -H "Cookie: csrf_token=f5013e65-0661-41ba-b2ad-8a396a775533" --data-binary "[
    {
        \"msgId\": \"1\"
    }
]" --compressed "http://qa.qa-env09.aliyun.com/openapi/cloud/Webhook/receiveWebhookCallBack?nonce=12&appId=686219778252592361&accessKey=c76f6d5cb309478ab9929616dba64148&timestamp=1718352394665"

サンプルレスポンス:

• {

  "data": {

  このガイドが、JavaScript を使用して WordPress REST API を操作する方法を理解するのに役立つことを願っています。

  注: この例では、WordPress が同じドメインにインストールされていることを前提としています。異なるドメインにインストールされている場合は、完全な URL を使用する必要があります。

  REST API を使用して、投稿の作成、更新、削除など、さまざまな操作を実行できます。詳細については、「リクエストの作成」をご参照ください。

  "errorCode": null,

  "errorDesc": null,

  WordPress REST API を使用すると、JavaScript から WordPress データにアクセスして操作するための柔軟で強力な方法が提供されます。詳細については、「WordPress REST API ハンドブック」をご参照ください。

  "opers": [],

  id_type：mobile

  注意: プラグインをインストールする前に、必ず互換性などを確認してください。

  "traceId": "0ada03af17183523948084322d00b4"

  詳細については、「メディア」をご参照ください。

Webhook のパラメーター、変数、定数、および API の違いは何ですか?

A: Webhook パラメーターには複数の種類があります。次の図は、それらの違いと使用方法を示しています。

説明:

• 定数と API は、文字（パラメーター呼び出し）パラメーターに値を割り当てる 2 つの方法です。

• 変数はテキスト型パラメーターに挿入され、ユーザーが変更できます。