動画
clips > delete
APIリクエストから動画を削除します。保存場所から関連付けられている画像とメディアファイルも削除されます。
リクエストの構築
リクエストURLとGET変数
リクエスト固有のGET変数
| 変数 | 値 | 説明 |
|---|---|---|
| go | clips | APIセクション |
| do | delete | APIアクション |
| iq | Clip ID | 動画ID |
リクエストURLは以下のようになります。必須情報(key, timestamp, salt, signature)を追加することを忘れないでください。
https://....../api.php?go=clips&do=delete&iq={clip_id}&{required information}
POST変数
このリクエストにはPOST変数は必要ありません。
応答例
リクエストが成功した場合は、以下の内容のレスポンスを受け取ります。
・ok:動画が正常に削除された場合
{
"ok": "The Clip was deleted"
}
動画が存在しない場合など、リクエストが失敗した場合のレスポンス
{
"error": "CLIP_NOT_FOUND",
"error_long": "It was not possible to find a Clip with the supplied ID"
}
このリクエストは以下のエラーを返す可能性があります。
・DELETION_ERROR | It was not possible to delete the Clip
動画を削除できませんでした。
・REQUEST_ERROR | Invalid Clip ID
動画IDが無効です。
・CLIP_NOT_FOUND | It was not possible to find a Clip with the supplied ID
動画が見つかりません。
その他のエラー内容に関しては一般的なエラーメッセージを確認してください。
PHPサンプルコード
GETおよびPOSTデータを準備します。
// GET変数 $GET_VARS = array( "go" => "clips", "do" => "delete", "iq" => 696 ); // POST変数 $POST_VARS = array();