ランダム画像 API と公開ギャラリー

この 2 つの機能はどちらも次の場所で設定します。

システム設定 -> その他の設定

ランダム画像 API

ランダム画像 API は、指定したディレクトリからランダムにファイルを 1 つ返します。サイト背景、アイコンローテーション、外部ページからのランダム画像呼び出しに向いています。

有効化後は次の URL を利用できます。

https://あなたのドメイン/random

API 設定

項目	説明
有効	/random を開閉します。無効時はアクセスが拒否されます
ディレクトリ	ランダム対象にできるディレクトリを制限します
呼び出し例	コピーして使える API URL を生成します

複数ディレクトリを選択できます。たとえば /landscape/ と /portrait/ だけを許可すると、それ以外のディレクトリからは返りません。

主なパラメータ

パラメータ	例	説明
dir	/landscape/	対象ディレクトリ
content	image	image、video、audio などの種類
orientation	auto	portrait、landscape、auto
type	url	空ならリダイレクト、url はテキスト、json は JSON
origin	1	type=url と組み合わせて完全 URL を返します
age	all-ages,r12	年齢レーティングで絞り込みます
tag	wallpaper,sky	指定タグを含むファイルだけにします
ex	private	指定タグを含むファイルを除外します

戻り値

type を指定しない場合、ランダムに選ばれたファイルへ直接リダイレクトします。

type=url は URL 文字列を返します。

type=json はリンク、ファイル ID、ファイル名、種類、タグ、レーティングなどを返します。

アクセス制御

ランダム画像 API は公開アクセス設定に従います。

ルール	影響
ディレクトリ制限	許可されたディレクトリ内だけが対象になります
ブラックリスト	ブラックリストのファイルは候補に入りません
ホワイトリストモード	公開許可されたファイルだけが返ります
年齢レーティング	R12、R16、R18 などを現在のアクセスモードで絞り込みます

条件に合うファイルがない場合は、該当なしとして返ります。

公開ギャラリー

公開ギャラリーは、訪問者が許可済みディレクトリを読み取り専用で閲覧できるページです。

https://あなたのドメイン/browse/ディレクトリ名

公開ギャラリー設定

項目	説明
有効	公開ギャラリーを開閉します
画像読み込みモード	原寸画像またはサムネイルを選びます
公開ディレクトリ	訪問者に見せるディレクトリを指定します

例：

/1/,/2/,/landscape/,/portrait/

この場合、訪問者は次の URL を開けます。

https://あなたのドメイン/browse/1
https://あなたのドメイン/browse/2
https://あなたのドメイン/browse/landscape
https://あなたのドメイン/browse/portrait

未公開のディレクトリへアクセスすると拒否されます。

ギャラリーでできること

機能	説明
ディレクトリ閲覧	公開ディレクトリ内のファイルとサブディレクトリを表示
検索	ファイル名、ID、タグで検索
種類フィルタ	画像、動画、音声、その他で絞り込み
タグフィルタ	指定タグを含む、または除外する
向きフィルタ	横長、縦長などで絞り込み
リンクコピー	公開リンクをコピー
メディアプレビュー	画像、動画、音声をページ上で確認