よくある質問 (FAQs)

業務要件：さまざまなユーザーニーズに対応するため、複数の購読モードをサポートする必要があります 1. 次の3つの購読モードがサポートされています。 - グローバル購読：すべての関連リソースのイベントを購読します。主アカウントが購読すると、すべてのサブアカウントはデフォルトで自動的に購読されます - ユーザー別購読：特定の object_ids を指定する必要があります。つまり、ユーザー ID です - アンケート別購読：特定の object_ids を指定する必要があります。つまり、アンケート ID です 2. 設定ルール： - グローバル購読を除き、その他のすべての購読モードでは対応する object_ids を含める必要があります - ユーザー別購読の場合、アンケート作成イベントには object_ids は不要です - アンケート別購読の場合、アンケート作成イベントは含めることができません

ビジネス上の質問: サポートされているイベントタイプと、その具体的な対象範囲を明確にする必要があります 1. 7種類のイベントタイプをサポートしています: - アンケートの作成 - アンケートの変更（質問の編集のみ。アンケート設定の変更は含まれません） - アンケートの削除 - 回答の完了 - 回答の更新 - 回答の削除 - 回答の無効化（無効となった理由を返します）

業務上の問題: セキュリティを確保するため、認可フィールドの長さを制御する必要があります 業務ルール: - 認可フィールドの長さは 0〜512 文字に制限されています

ビジネス上の問題: webhook コールバックの信頼性を確保する必要がある ビジネスルール: 1. 最大5回まで再試行 2. 再試行間隔: - 1回目の再試行: 10秒 - 2回目の再試行: 1分 - 3回目の再試行: 5分 - 4回目の再試行: 30分（プッシュ失敗に関するリマインドメールを送信） - 5回目の再試行: 1日（プッシュが無効になったことに関するリマインドメールを送信）

業務上の問題：連続した失敗を処理し、ユーザーに通知する必要があります 業務ルール： 1. システムは同じURLを持つすべてのWebhookを自動的に無効化に設定します 2. ユーザーにメール通知を送信します（メールは主アカウント宛てに送信されます） 3. 失敗記録をWebhook IDをキーとする別のキューに保存します（7日間保持されます） 4. ユーザーは7日以内にデータをバックフィルできます

業務上の課題: webhook が無効化されている期間中にイベントを処理する必要があります 1. 無効化後 7 日以内のイベント記録は別のキューに保存されます 2. 無効化の回数が 1 回を超える場合は、技術サポートにお問い合わせください 3. 再有効化後、キューに入っていたデータは自動的にプッシュされます

ビジネス上の要件: webhook の呼び出しログをトラブルシューティングのために記録する必要があります 業務ルール: - コールバックには Alibaba Cloud のログレコードを JSON 形式で含める必要があります

ビジネス上の課題: webhook 設定の重複を防止する必要があります ビジネスルール: 1. 次のフィールドの組み合わせは一意でなければなりません: - subscription_model (サブスクリプションモード) - event_type (イベントタイプ) - object_ids (オブジェクトID) - url_subscription (サブスクリプションURL) 2. 例外: 異なるイベントに対して同じ url_subscription を使用することは制限されません

業務上の質問: 統一された時間形式が必要であり、リソースアクセスリンクも必要です。 業務ルール: 1. イベント時刻はミリ秒単位のタイムスタンプを返します。 2. プッシュパラメータにはリソースアクセスURLが含まれます。

ビジネス上の質問：webhook のステータスの種類と、その影響を明確にする必要があります ビジネスルール： webhook のステータスは 4 種類に分かれます： 1. 履歴データ（status=0） 2. 利用可能（status=1） 3. 利用不可（status=2、プッシュなし） 4. システム無効（status=3、複数回のコールバック失敗）