Webhook とは?
Webhook を使用すると、特定のシステム アクション が発生したときに、提供された URL への呼び出しを通じて通知を受け取ることができます。Webhook は「URL コールバック」または「HTTP プッシュコール」とも呼ばれます。URL は SSL を使用し、HTTPS で始まる必要があります。Webhook アクション
Webhook で利用可能なアクションを確認します。
Ayrshare Webhook を理解する
Webhook は特定のアクションによって分類され、Primary Profile または User Profile レベルで登録 されます。Primary または User Profile への更新は、まず User Profile 用に登録された Webhook に送信されます。User Profile に登録された Webhook がない場合、更新は Primary Profile に登録された Webhook に送信されます。 たとえば:- User Profile に登録された Social Action Webhook があり、TikTok のリンクを解除した場合、User Profile 用に登録された Social Action Webhook URL が呼び出されます。Primary Profile の Webhook は呼び出されません。
- User Profile が TikTok のリンクを解除し、登録された Social Action Webhook がないが、Primary Profile に登録された Webhook がある場合、Primary Profile 用に登録された Social Action Webhook URL が呼び出されます。
Webhook を登録する
エンドポイント URL とアクションタイプを POST/hook/webhook エンドポイントに提供して Webhook を登録します。アクションが発生すると、提供された URL に HTTP POST メッセージが送信されます。
たとえば、スケジュール投稿のステータス通知を受け取るために URL を登録します。
Webhook エンドポイント URL はリダイレクトを使用してはならず、最終的な宛先 URL である必要があります。
Primary Profile の Webhook のみを登録した場合、User Profile は自動的に Primary Profile の Webhook を継承します。
各 User Profile に一意の Webhook を持たせるには、User Profile ごとに Webhook を登録する必要があります。
Webhook が
HTTP POST を受信した後、サーバーは呼び出しを成功としてマークするために、HTTP ステータス 200 で応答する 必要があります。サーバーが 10 秒以内に応答しない場合、503 レスポンスが記録されます。Webhook の再試行
サーバーからの HTTP レスポンスが200-299 の成功範囲にない場合、システムは Webhook 呼び出しを自動的にさらに 2 回再試行します。最初の再試行は 5 秒後、2 番目の再試行はその 30 秒後に行われます。再試行は同じ hookId を持ち、再試行の試みとしてマークされます。