랜덤 이미지 API와 공개 갤러리

두 기능은 모두 다음 위치에서 설정합니다.

시스템 설정 -> 기타 설정

랜덤 이미지 API

랜덤 이미지 API는 지정한 디렉터리에서 파일 하나를 무작위로 골라 반환합니다. 사이트 배경, 프로필 이미지 로테이션, 외부 페이지의 랜덤 이미지 호출에 사용할 수 있습니다.

사용하면 다음 주소를 호출할 수 있습니다.

https://내도메인/random

API 설정

항목	설명
사용	/random 인터페이스를 켜거나 끕니다. 꺼져 있으면 접근이 거부됩니다
디렉터리	랜덤 대상이 될 수 있는 디렉터리를 제한합니다
호출 예시	바로 복사해 쓸 수 있는 랜덤 이미지 API 링크를 만듭니다

디렉터리는 여러 개 선택할 수 있습니다. 예를 들어 /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은 텍스트 링크를 반환합니다.

type=json은 파일 링크, 파일 ID, 파일명, 파일 형식, 태그, 등급 같은 정보를 반환합니다.

접근 제한

랜덤 이미지 API는 관리자 화면의 공개 접근 규칙을 따릅니다.

규칙	효과
디렉터리 제한	허용된 디렉터리 안의 파일만 선택
블랙리스트	블랙리스트 파일은 후보에서 제외
화이트리스트 모드	공개 허용된 파일만 반환
연령 등급	현재 접근 모드에 따라 R12, R16, R18 등을 필터링

조건에 맞는 파일이 없으면 매칭 결과가 없다는 응답을 반환합니다.

공개 갤러리

공개 갤러리는 방문자가 허용된 디렉터리를 읽기 전용으로 둘러볼 수 있는 페이지입니다.

https://내도메인/browse/디렉터리명

공개 갤러리 설정

항목	설명
사용	공개 갤러리를 켜거나 끕니다
이미지 로딩 모드	원본 이미지 또는 썸네일 사용 여부를 정합니다
공개 디렉터리	방문자가 접근할 수 있는 디렉터리를 지정합니다

예를 들어 다음처럼 입력하면:

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

방문자는 다음 주소에 접근할 수 있습니다.

https://내도메인/browse/1
https://내도메인/browse/2
https://내도메인/browse/landscape
https://내도메인/browse/portrait

공개하지 않은 디렉터리는 접근이 거부됩니다.

갤러리 기능

기능	설명
디렉터리 탐색	공개 디렉터리 안의 파일과 하위 디렉터리를 확인
검색	파일명, 파일 ID, 태그로 검색
형식 필터	이미지, 동영상, 오디오, 기타 파일로 필터링
태그 필터	지정 태그 포함 또는 제외
방향 필터	가로형, 세로형 등으로 필터링
링크 복사	파일 접근 링크 복사
미디어 미리보기	이미지, 동영상, 오디오를 페이지에서 확인