Callback概要
Kollusサービスの利用中、進行状況はCMSを通じて直接確認することができます。しかし、便利さのために、各進行状況ごとに事前に設定された顧客のWeb URLに進行状況を送信しています。
これをKollus Callbackサービスと呼びます。また、顧客のWeb URLへのCallback送信が失敗した場合には再試行します。
各再試行ごとに内部的にログを記録し、すべての再試行が失敗した場合には、問題のあったCallback送信の原因を特定し、正常にCallbackを送信できるようにします。
このドキュメントは、Callback送信および再試行に関するKollus Callback送信サーバーの処理過程について説明します。
Callbackの設定は、チャンネルに関連する部分の設定については、管理者権限を持つユーザーがそのチャンネルの運営ポリシー設定画面で指定することができます。
その他のCallbackについては、Kollusサービス担当者に設定を依頼する必要があります。
必要なChannel Callbackを登録します。
その他Callbackの設定は (Upload callback, Transcoding Callback, Contents update callback, Drop-off callback) Kollus サービス担当にお問い合わせください。
全てのCallbackはお客様が設定したWeb URLの80番ポートにPOST方式を利用して転送します。
全てのCallbackは転送時点になると、即時転送することを原則とします。(Callbackを処理するサーバーの負荷状況により遅延される可能性があります。)
顧客側のWebサーバーがCallbackを受け取った場合、200 HTTP Status Codeでレスポンスしなければなりません。レスポンス内容のHTTP body部分は確認しません。(200以外のコードでレスポンスした場合には転送失敗と見なし、指定時間後に転送をリトライします。)
顧客側のサーバーはKollusのCallback転送リクエストに対して2秒以内にアクセスし、接続から3秒以内にレスポンスを返さなければなりません。
時間内にアクセスがないまたは応答がなかった場合にはKollus Callback転送サーバーは転送失敗と見なして指定された時間後にリトライします。(Connect Time-out 2秒, Response Time-out 3秒)
基本的な内容は「Callback転送処理」項目と同一です。
顧客のサーバーがKollusのCallbackを正常に処理したと見なして200 HTTPステータスコードで応答した場合でも、接続/応答タイムアウトを超えてKollus Callback送信サーバーがリクエストを失敗として処理した場合、Callbackリクエストが再試行されることがあります。つまり、タイムアウトによる同じCallbackがリクエストされる可能性があるため、Callback URLを開発する際にはその点に注意する必要があります。
