動画
clips > get_aws_signed_url
CloudFrontの署名付きURLをリクエストします。
署名付きURLについてはこちらをご確認ください。
リクエストの構築
リクエストURLとGET変数
リクエスト固有のGET変数
| 変数 | 値 | 説明 |
|---|---|---|
| go | clips | APIセクション |
| do | get_aws_signed_url | APIアクション |
| iq | URL | CloudFrontの署名が必要なURL(URLエンコード) |
リクエストURLは以下のようになります。必須情報(key, timestamp, salt, signature)を追加することを忘れないでください。
https://....../api.php?go=clips&do=get_aws_signed_url&iq={url}&{required information}
POST変数
以下のPOST変数は必須です。
| 変数 | 値 | 説明 |
|---|---|---|
| id_clip | (int) Clip ID | メディアが関連付けられている動画のID |
以下のPOST変数はオプションですが推奨されています。
| 変数 | 値 | 説明 |
|---|---|---|
| ip | (string) IP Address | メディアを視聴するユーザーのIP。 指定しない場合、システムは検出されたIP(メディアを視聴するユーザーのIPと一致する、または一致しない可能性があるアプリケーションのIP)を使用します。 |
応答例
リクエストが成功した場合は、以下の内容のレスポンスを受け取ります。
・original_url:オリジナルのURL
・signed_url:署名付きURL
・used_ip:署名の生成に使用されたIP
{
"original_url": "http:\/\/...urltosign...",
"signed_url": "http:\/\/...urltosign...?Expires=1427540397&Signature=Za4ayDEUE4ZP0R3kURi4JUYOToHkK-aqN3NGYmEqWjUgIT8e8qGRMwfeicQc~nJYauXgRi62KVeBDK1I35t~MUQCMUD09hJ9zoaIWInHn0kQrFleXQ7iw2PPQ1s16KU-2dcFEW21NwLz4k3xdRk03VOhDREYWpc~uZBitrGwBRtB7DWYIWME8RNDa3JsZA2GYA41XS48WUlDa37n1A7rk9sp-whqs-5LfwnicSrHkmYDWi75zsrORspvY7ISr1jioxa8ZvET73OienS2dX6X5B-w9VmSBO~3NTCg7lqW8WOT00gCtI2F2Y43G1QYiWbsRL5M~Ud993sTU6QnPjku9w__&Key-Pair-Id=APKAI5ZNIJUFLK5E36WQ&Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cDovL3VybHRvc2lnbi4uLiIsIkNvbmRpdGlvbiI6eyJJcEFkZHJlc3MiOnsiQVdTOlNvdXJjZUlwIjoiNjIuMTE3LjIyNC44Ny8zMiJ9LCJEYXRlTGVzc1RoYW4iOnsiQVdTOkVwb2NoVGltZSI6MTQyNzU0MDM5N319fV19",
"used_ip": "xxx.xxx.xxx.xxx"
}
リクエストにハッシュが指定されていない場合など、リクエストが失敗した場合のレスポンス
{
"error" : "REQUEST_ERROR",
"error_long" : "Missing signature"
}
エラー内容に関しては一般的なエラーメッセージを確認してください。
PHPサンプルコード
GETおよびPOSTデータを準備します。
// GET変数
$GET_VARS = array(
"go" => "clips",
"do" => "get_aws_signed_url",
"iq" => "http://...urltosign..."
);
// POST変数
$POST_VARS = array(
"id_clip" => 13,
"ip" => "xxx.xxx.xxx"
);