動画
clips > get_restricted_viewable_embed_code
アクセス制限付きの動画が表示可能な埋め込みコードを取得します。
埋め込みコードを通じて、特定のユーザーがINTER-STREAMの制限付き動画に一時的にアクセスすることを許可したい場合、このAPIリクエストは指定されたオプションに従って表示可能な埋め込みコードを生成します。
注：このリクエストを使用する前に、使用する動画IDとユーザーIDが有効であることを確認してください（IDに整数を指定する限り、システムは埋め込みコードを生成します）。
リクエストの構築
リクエストURLとGET変数
リクエスト固有のGET変数
| 変数 | 値 | 説明 |
|---|---|---|
| go | clips | APIセクション |
| do | get_restricted_viewable_embed_code | APIアクション |
| iq | Clip ID | 動画ID |
リクエストURLは以下のようになります。必須情報(key, timestamp, salt, signature)を追加することを忘れないでください。
https://....../api.php?go=clips&do=get_restricted_viewable_embed_code&iq={url}&{required information}
POST変数
以下のPOST変数は必須です。
| 変数 | 値 | 説明 |
|---|---|---|
| id_user | (int) User ID | INTER-STREAM内のユーザーID |
以下のPOST変数はオプションですが推奨されています。
| 変数 | 値 | 説明 |
|---|---|---|
| ip_user | (string) IP Address | メディアを視聴するユーザーのIP。 指定しない場合、システムは検出されたIP（動画を視聴するユーザーのIPと一致する、または一致しない可能性があるアプリケーションのIP）を使用します。 |
| expiration | (int) seconds | 埋め込みコードの有効期限（秒/リクエスト時間を考慮します）。 この時間が経過すると、埋め込みコードは機能しなくなります。 |
| embedWidth | (int) width | 埋め込みコードの幅(px) |
| embedHeight | (int) height | 埋め込みコードの高さ(px) |
| embedURLVars | (string) "&var1=value1..." | 埋め込みコードの動画プレーヤーURL変数。 可能なURL変数はこちらでご確認ください。 |
応答例
リクエストが成功した場合は、以下の内容のレスポンスを受け取ります。
・embed_code_iframe：<iframe>タグでの埋め込みコード
・embed_code_object：<object>タグでの埋め込みコード
{
"embed_code_iframe": "<iframe src=\"http:\/\/......\/embed.php?id=401&w=400&h=300&autoplay=1&permission=eyJ0aW1lc3RhbXAiOjE0Mjc1NDAzMTAsImV4cGlyYXRpb24iOjM2MDAsImlkX3VzZXIiOjIsImlwX3VzZXIiOiI2Mi4xMTcuMjE2LjExIiwia2V5IjoiMWIzMjNhMWNiODc5ZmQ0ZTY2NTMwZmJhZDA3YTMyZWUifQ%3D%3D&signature=23EXYoB3mqUDkCm6rYo%2BxY309UOuEvjM2kVr4fn4%2FNI%3D\" scrolling=\"no\" frameborder=\"0\" style=\"border:none; overflow:hidden; width:400px; height:300px;\" webkitAllowFullScreen mozallowfullscreen allowFullScreen><\/iframe>",
"embed_code_object": "<div id=\"videoContainer401\"><object classid=\"clsid:D27CDB6E-AE6D-11CF-96B8-444553540000\" id=\"embeddedVideo\" width=\"400\" height=\"300\" codebase=\"http:\/\/download.macromedia.com\/pub\/shockwave\/cabs\/flash\/swflash.cab#version=10,1,0,0\" style=\"border:none\" ><param name=\"movie\" value=\"http:\/\/......\/public\/common\/player.swf?type=clip&id=401&viddiv=videoContainer401&autoplay=1&permission=eyJ0aW1lc3RhbXAiOjE0Mjc1NDAzMTAsImV4cGlyYXRpb24iOjM2MDAsImlkX3VzZXIiOjIsImlwX3VzZXIiOiI2Mi4xMTcuMjE2LjExIiwia2V5IjoiMWIzMjNhMWNiODc5ZmQ0ZTY2NTMwZmJhZDA3YTMyZWUifQ%3D%3D&signature=23EXYoB3mqUDkCm6rYo%2BxY309UOuEvjM2kVr4fn4%2FNI%3D\"><\/param><param name=\"allowFullScreen\" value=\"true\"><\/param><param name=\"allowscriptaccess\" value=\"always\"><\/param><param name=\"SCALE\" value=\"ExactFit\"><\/param><param name=\"quality\" value=\"High\"><\/param><param name=\"loop\" value=\"false\"><\/param><param name=\"swliveconnect\" value=\"true\"><\/param><param name=\"wmode\" value=\"opaque\"><\/param><embed name=\"embeddedVideo\" width=\"400\" height=\"300\" src=\"http:\/\/......\/public\/common\/player.swf?type=clip&id=401&viddiv=videoContainer401&autoplay=1&permission=eyJ0aW1lc3RhbXAiOjE0Mjc1NDAzMTAsImV4cGlyYXRpb24iOjM2MDAsImlkX3VzZXIiOjIsImlwX3VzZXIiOiI2Mi4xMTcuMjE2LjExIiwia2V5IjoiMWIzMjNhMWNiODc5ZmQ0ZTY2NTMwZmJhZDA3YTMyZWUifQ%3D%3D&signature=23EXYoB3mqUDkCm6rYo%2BxY309UOuEvjM2kVr4fn4%2FNI%3D\" type=\"application\/x-shockwave-flash\" pluginspage=\"http:\/\/www.macromedia.com\/go\/getflashplayer\" allowscriptaccess=\"always\" quality=\"High\" loop=\"false\" allowfullscreen=\"true\" scale=\"exactFit\" swliveconnect=\"true\"><\/embed><\/object><\/div>"
}
リクエストにハッシュが指定されていない場合など、リクエストが失敗した場合のレスポンス
{
"error" : "REQUEST_ERROR",
"error_long" : "Missing signature"
}
このリクエストは以下のエラーを返す可能性があります。
・REQUEST_ERROR | Invalid Clip ID
動画IDが1未満かもしくは数値ではありません。
・REQUEST_ERROR | Invalid User ID
ユーザーIDが1未満かもしくは数値ではありません。
・REQUEST_ERROR | Invalid expiration time
指定された有効期限が1未満かもしくは数値ではありません。
その他のエラー内容に関しては一般的なエラーメッセージを確認してください。
PHPサンプルコード
GETおよびPOSTデータを準備します。
// GET変数
$GET_VARS = array(
"go" => "clips",
"do" => "get_restricted_viewable_embed_code",
"iq" => 401
);
// POST変数
$POST_VARS = array(
"id_user" => 2,
"ip_user" => "xxx.xxx.xxx.xxx",
"expiration" => 3600,
"embedWidth" => 400,
"embedHeight" => 225,
"embedURLVars" => "&autoplay=1"
);
salt, timestamp, signatureを生成してリクエストを送信します。
以下のコードブロックはすべてのハッシュつきリクエストに共通です。
// APIベースURLと認証情報の収集
$API_URL = "https://www.interstreamdomain.tv/api.php";
$API_KEY_ID = "1b323a1cb879fd4e66530fbad07a32ee";
$API_SHARED_SECRET = "MWIzMjNhMWNiODc5ZmQ0ZTY2NTMwZmJhZDA3YTMyZWViOTQ3MDJiOGM2ZTU2NjE3"; // 公開しないでください
// salt, timestamp, signatureの生成
$salt = md5(mt_rand());
$timestamp = time();
$signature = base64_encode(hash_hmac('sha256', $salt.$timestamp, $API_SHARED_SECRET, true));
// key, salt, timestamp, signatureをGET変数に追加
$GET_VARS["timestamp"] = $timestamp; // UTCタイムスタンプ
$GET_VARS["salt"] = $salt;
$GET_VARS["key"] = $API_KEY_ID ; // APIキーID:これは公開されており、アプリケーションを識別するためにAPIによって使用されます
$GET_VARS["signature"] = $signature;
// リクエストURLを作成します。HTTPクエリを作成するためにPHPの組み込み関数を使用しない場合は、値をURLエンコードすることを忘れないでください。
$REQUEST_URL = $API_URL."?".http_build_query($GET_VARS);
// ".../api.php?go=api_subject&do=api_action&etc..."のようにURLを構築
// 新しいcURLリソースを作成して適切なオプションを設定
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $REQUEST_URL);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_POSTFIELDS, $POST_VARS);
// PHPホストに有効なSSL証明書がない場合は、SSL証明書の検証を無効にする必要があります。これは危険であり、有効な証明書がインストールされるまで一時的に行われるべきです。
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); // Turns off verification of the SSL certificate.
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // Turns off verification of the SSL certificate.
// APIにリクエストを送信
$response = curl_exec($ch);
// レスポンス処理
if (!$response) {
echo 'API call failed';
}
else
{
print_r(json_decode($response,true));
}