印刷する

動画

clips > geo_block_check

APIリクエストからIP/国コード単位での動画へのアクセスが許可されているかどうかを確認します。

リクエストの構築

リクエストURLとGET変数

リクエスト固有のGET変数

変数値説明
goclipsAPIセクション
dogeo_block_checkAPIアクション
iqClip ID動画ID

リクエストURLは以下のようになります。必須情報(key, timestamp, salt, signature)を追加することを忘れないでください。

https://....../api.php?go=clips&do=geo_block_check&iq={id_clip}&{required information}
POST変数

以下のPOST変数は必須です。

変数値説明
ip (string) IP Address ユーザーのIPアドレス

以下のPOST変数はオプションです。

変数値説明
country_code (string) Two-letter country code 2文字のISO 3166-1国別コード
注：国コードが空欄の場合はIPから取得されます。

応答例

リクエストが成功した場合は、以下の内容のレスポンスを受け取ります。
・allow：可能な値：0（IPは許可されていません）, 1（IPは許可されています）

{
    "allow": 1
}

リクエストにIPが指定されていない場合など、リクエストが失敗した場合のレスポンス

{
	"error"		 : "REQUEST_ERROR",
	"error_long" : "Invalid IP"
}

このリクエストは以下のエラーを返す可能性があります。

・REQUEST_ERROR | Invalid IP
IPが指定されていないか、無効なIPです。

・REQUEST_ERROR | Invalid Clip ID:
動画IDが1未満かもしくは数値ではありません。

その他のエラー内容に関しては一般的なエラーメッセージを確認してください。

PHPサンプルコード

GETおよびPOSTデータを準備します。

// GET変数
$GET_VARS = array( 
					"go"        => "clips",
					"do"        => "geo_block_check",
					"iq"        => 456
					);

// POST変数
$POST_VARS = array(
					"ip"	=> "4.4.4.4"
                    );