動画視聴完了


動画視聴完了

友だちが、初めて最後まで動画視聴完了した際に指定されたURLにイベントを送信します。

署名の検証

受信したwebhookイベントがPosterから送信された正当なものである事を確認するため、必ず署名の検証を行って下さい。

  • 発行された「webhook_key」を秘密鍵として、HMAC-SHA256アルゴリズムを使用してリクエストボディのダイジェスト値を取得します。
  • ダイジェスト値をBase64エンコードした値と、リクエストヘッダーのX-Poster-Signatureに含まれる署名が一致することを確認します。
検証用の署名 リクエストヘッダー「X-Poster-Signature」でbase64エンコードされた署名情報が送信されます。
署名検証用のキー(webhook_key) Posterから発行された40文字の文字列 (Poster管理画面から確認して下さい。)

イベントオブジェクト

Webhookで送信されるイベントはJSON形式の文字列をリクエストBodyとして指定されたURLにPOST送信されます。

※右にスクロールできます。

プロパティ名 説明
event 文字列 video_play_complete
movie_url 文字列 動画URL
message_id 数字 メッセージID
postback_data 文字列 動画視聴完了イベントで設定した任意の文字列
user オブジェクト
パラメータ名 説明
poster_user_id 数字 Posterで管理されるユーザーID
line_user_id 文字列 LINE Messaging APIで使用するuserId
member_code 文字列 Posterで管理される会員番号

Requestデータサンプル

{
    "event": "video_play_complete",
    "message_id": "9999999"
    "movie_url": "https://xxxxxxxx.xx.xx"
    "postback_data": "campaign-movie-2022-01"
    "user": {
        "poster_user_id": 77777777777,
        "line_user_id": "Udeadbeefdeadbeefdeadbeefdeadbeef",
        "member_code": "20-666666-666666",
    }
}

※ LINE 及び LINE公式アカウント はLINE株式会社の商標または登録商標です。PosterはLINE株式会社が提供する LINE Messaging API を利用しています。