รูปภาพสุ่มและแกลเลอรีสาธารณะ

ทั้งสองฟีเจอร์ตั้งค่าได้ที่:

System Settings -> Other Settings

API รูปภาพสุ่ม

API รูปภาพสุ่มจะคืนไฟล์แบบสุ่มหนึ่งไฟล์จากไดเรกทอรีที่เลือก เหมาะสำหรับพื้นหลังไซต์ การหมุนเวียนอวาตาร์ หรือการเรียกรูปภาพสุ่มจากหน้าภายนอก

หลังเปิดใช้งาน ให้ใช้:

https://your-domain.com/random

การตั้งค่า API รูปภาพสุ่ม

ตัวเลือก	จุดประสงค์
เปิดใช้	เปิดหรือปิดปลายทาง /random เมื่อปิดอยู่ ระบบจะปฏิเสธการเข้าถึง
ไดเรกทอรี	จำกัดว่า API สุ่มสามารถใช้ไดเรกทอรีใดได้บ้าง ไดเรกทอรีที่ไม่ได้รวมไว้ที่นี่จะใช้กับ API ไม่ได้
ตัวอย่างการเรียก	สร้างลิงก์ API สุ่มที่คุณคัดลอกได้โดยตรง

คุณสามารถเลือกได้หลายไดเรกทอรี ตัวอย่างเช่น หากอนุญาตเฉพาะ /landscape/ และ /portrait/ API สุ่มจะเลือกไฟล์ได้เฉพาะจากไดเรกทอรีเหล่านั้นและไดเรกทอรีย่อยของมัน

พารามิเตอร์ API รูปภาพสุ่ม

พารามิเตอร์	ตัวอย่าง	จุดประสงค์
dir	/landscape/	ระบุไดเรกทอรีสุ่ม
content	image	ระบุชนิดสื่อ ใช้ image, video, audio หรือรวมหลายค่าโดยคั่นด้วยจุลภาค
orientation	auto	กรองแนวภาพ ใช้ portrait, landscape หรือ auto
type	url	รูปแบบผลลัพธ์ ค่าว่างหมายถึงเปลี่ยนเส้นทาง, url คืน URL แบบข้อความล้วน, json คืน JSON
origin	1	ใช้ร่วมกับ type=url เพื่อคืน URL แบบเต็ม
age	all-ages,r12	กรองตามระดับอายุ
tag	wallpaper,sky	คืนเฉพาะไฟล์ที่มีแท็กเหล่านี้
ex	private	ไม่รวมไฟล์ที่มีแท็กเหล่านี้

รูปแบบผลลัพธ์

หากไม่มี type API จะเปลี่ยนเส้นทางไปยัง URL ของไฟล์สุ่มโดยตรง

เมื่อใช้ type=url จะคืน URL แบบข้อความ

เมื่อใช้ type=json จะคืนข้อมูลไฟล์ รวมถึง URL ไฟล์, ID ไฟล์, ชื่อไฟล์, ประเภทไฟล์, แท็ก, เรตติ้ง และเมทาดาทาที่เกี่ยวข้อง

กฎการเข้าถึง

API รูปภาพสุ่มทำตามกฎการเข้าถึงสาธารณะ:

กฎ	ผล
จำกัดไดเรกทอรี	เลือกได้เฉพาะไฟล์ในไดเรกทอรีที่อนุญาต
รายการบล็อก	ไฟล์ในรายการบล็อกจะถูกตัดออกจากชุดสุ่ม
โหมดรายการอนุญาต	เมื่อเปิดใช้ จะคืนเฉพาะไฟล์ที่อนุญาตให้เข้าถึงแบบสาธารณะ
ระดับอายุ	เนื้อหา R12, R16, R18 และเนื้อหาใกล้เคียงจะถูกกรองตามโหมดการเข้าถึงปัจจุบัน

หากไม่มีไฟล์ที่ตรงหลังการกรอง API จะไม่คืนผลลัพธ์ที่ตรงกัน

แคช

API รูปภาพสุ่มแคชชุดตัวเลือกของไดเรกทอรีเพื่อเพิ่มความเร็ว

หลังไฟล์เปลี่ยน ImgHost จะอัปเดตเวอร์ชันแคชของไดเรกทอรี และคำขอถัดไปจะสร้างชุดตัวเลือกใหม่ ไดเรกทอรีว่างจะถูกแคชชั่วครู่เพื่อหลีกเลี่ยงการสืบค้นซ้ำ

แกลเลอรีสาธารณะ

แกลเลอรีสาธารณะให้บริการหน้าเรียกดูแบบอ่านอย่างเดียวสำหรับไดเรกทอรีที่คุณอนุญาตให้ผู้เยี่ยมชมเห็น

หลังเปิดใช้งาน ผู้เยี่ยมชมสามารถเปิด:

https://your-domain.com/browse/directory-name

การตั้งค่าแกลเลอรีสาธารณะ

ตัวเลือก	จุดประสงค์
เปิดใช้	เปิดหรือปิดแกลเลอรีสาธารณะ เมื่อปิด ผู้เยี่ยมชมจะเรียกดูไม่ได้
โหมดโหลดรูปภาพ	ควบคุมว่าตัวอย่างใช้รูปภาพต้นฉบับหรือภาพขนาดย่อ
ไดเรกทอรีที่เปิดให้เข้าถึง	กำหนดไดเรกทอรีที่ผู้เยี่ยมชมเข้าถึงได้

โหมดโหลดรูปภาพ

โหมด	จุดประสงค์
ต้นฉบับ	หน้าผู้เยี่ยมชมโหลดไฟล์ต้นฉบับโดยตรง
ภาพขนาดย่อ	หน้าผู้เยี่ยมชมเลือกใช้ภาพขนาดย่อเพื่อโหลดเร็วขึ้น

ไดเรกทอรีที่เปิดให้เข้าถึง

ไดเรกทอรีที่เปิดให้เข้าถึงกำหนดว่าผู้เยี่ยมชมจะเห็นอะไรได้บ้าง

ตัวอย่าง:

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

จากนั้นผู้เยี่ยมชมจะเข้าถึงได้:

https://your-domain.com/browse/1
https://your-domain.com/browse/2
https://your-domain.com/browse/landscape
https://your-domain.com/browse/portrait

สามารถเปิดไดเรกทอรีย่อยได้เช่นกัน เช่น /2026/lucky/ ผู้เยี่ยมชมจะถูกบล็อกจากไดเรกทอรีที่ไม่ได้เปิด

ฟีเจอร์ของแกลเลอรีสาธารณะ

ฟีเจอร์	คำอธิบาย
เรียกดูไดเรกทอรี	ดูไฟล์และไดเรกทอรีย่อยในไดเรกทอรีที่เปิดให้เข้าถึง
ค้นหา	ค้นหาตามชื่อไฟล์, ID ไฟล์ หรือแท็ก
ตัวกรองประเภท	กรองรูปภาพ วิดีโอ เสียง หรือไฟล์อื่น
ตัวกรองแท็ก	รวมหรือยกเว้นแท็กที่เลือก
ตัวกรองแนวภาพ	กรองรูปภาพแนวนอนหรือแนวตั้ง
ตัวกรองเวลา	กรองตามช่วงเวลาอัปโหลด
ตัวกรองนามสกุล	กรองตามนามสกุลไฟล์
คัดลอกลิงก์	คัดลอกลิงก์เข้าถึงไฟล์
ตัวอย่างสื่อ	ดูหรือเล่นรูปภาพ วิดีโอ และเสียงบนหน้าผู้เยี่ยมชม

กฎการเข้าถึงแกลเลอรีสาธารณะ

แกลเลอรีสาธารณะก็ทำตามกฎการเข้าถึงสาธารณะเช่นกัน:

กฎ	ผล
ไดเรกทอรีที่เปิดให้เข้าถึง	แสดงเฉพาะไดเรกทอรีที่อนุญาต
โหมดการเข้าถึง	เนื้อหาถูกกรองตามโหมดการเข้าถึงระดับอายุปัจจุบัน
โหมดรายการอนุญาต	เมื่อเปิดใช้ จะแสดงเฉพาะไฟล์ที่อนุญาตให้เข้าถึงแบบสาธารณะ
รายการบล็อก	ไฟล์ในรายการบล็อกจะถูกซ่อน