คู่มือเชื่อมต่อเอเจนต์กับ Huangguo

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

คู่มือนี้มี 12 ภาษา แต่พารามิเตอร์ locale ของ API ปัจจุบันรับเฉพาะ zh (จีนตัวย่อ) และ en (อังกฤษ) การแปลคู่มือไม่ได้เพิ่มภาษาที่ API รองรับ

MCP

คัดลอกปลายทาง Streamable HTTP นี้ไปยังไคลเอนต์ MCP:

https://huangguodrama.ai/api/agent/mcp/

search_titles — ค้นหาและกรองเรื่องที่เผยแพร่แล้ว
get_title — ข้อมูลเรื่องและหลักฐาน
list_episodes — วิดีโอที่เผยแพร่แล้วและลิงก์รับชม

HTTP

OpenAPI 3.1

curl 'https://huangguodrama.ai/api/agent/v1/search/?locale=en&limit=10'
curl 'https://huangguodrama.ai/api/agent/v1/titles/10438/?locale=en'
curl 'https://huangguodrama.ai/api/agent/v1/titles/10438/episodes/?page=1&limit=20'

ตัวกรองและข้อจำกัด

q, genre, audio, subtitle, completeness, min_duration, max_duration, duration_scope, locale, featured, page, limit

genre ใช้ ID หมวดที่ส่งกลับมา รหัสภาษาใช้ค่าที่วัดจากสื่อจริง (เช่น zh, en, zh-Hans) ตัวกรอง audio/subtitle กำหนดให้วิดีโอที่เผยแพร่ทุกคลิปตรงเงื่อนไข completeness คือ complete, partial, unknown ระยะเวลาเป็นวินาที duration_scope คือ published (ค่าเริ่มต้น) หรือ complete_work ส่วน locale คือ zh หรือ en และ featured คือ true หรือ false ค่าที่ไม่ทราบจะไม่ผ่านเงื่อนไขบังคับ

ค่าเริ่มต้น 10 ผลลัพธ์ สูงสุด 20 ต่อหน้า รวม HTTP และ MCP ไม่เกิน 60 คำขอต่อ IP ต่อนาที คำค้นไม่เกิน 160 ตัวอักษร คำขอ MCP ไม่เกิน 16 KiB ข้อผิดพลาด: 400 ข้อมูลไม่ถูกต้อง, 403 ไม่อนุญาต Origin, 404 ไม่พบเรื่องหรือยังไม่เผยแพร่, 413 เนื้อหาคำขอใหญ่เกินไป, 429 เกินอัตราคำขอ, 503 ปิดใช้งานหรือไม่พร้อมใช้งาน รองรับคำขอจากเซิร์ฟเวอร์ที่ไม่มี Origin

ขอบเขตและหลักฐาน

มี 834 เรื่องที่เผยแพร่แล้ว และรายการคัดสรรคงที่ 30 เรื่องที่เลือกจากจำนวนเริ่มเล่นในช่วงเจ็ดวัน เวลาบันทึกรายการคัดสรร: 2026-09-20T10:46:04.829Z

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

การระบุแหล่งที่มาและการทดสอบ

watch_url เป็น URL หลัก ส่วน attributed_watch_url เพิ่มเครื่องหมายที่เซิร์ฟเวอร์ลงลายมือชื่อ ผูกกับเรื่องและใช้ได้ 24 ชั่วโมง จำนวนคำขอ การเข้าถึงผ่านเบราว์เซอร์ การเล่นจริง การดูสะสม 30 วินาที และการคลิกตอนถัดไปวัดแยกกัน ตั้ง X-Agent-Test: true สำหรับการทดสอบ เครื่องหมายที่ลงลายมือชื่อจะเก็บค่านี้ไว้ ชื่อไคลเอนต์และ User-Agent เป็นเพียงข้อมูลช่วยวิเคราะห์ ไม่ใช่การยืนยันตัวตนของเอเจนต์