動画視聴完了
動画視聴完了
友だちが、初めて最後まで動画視聴完了した際に指定された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 | オブジェクト | |||||||||
|
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",
}
}