ผลลัพธ์เว็บแบบมีโครงสร้างในคำขอเดียว

1. ส่งคำขอแรกของคุณ

q เป็นพารามิเตอร์เดียวที่จำเป็น ระดับสาธารณะไม่ต้องใช้ส่วนหัว Authorization เหมาะกับการทดสอบและการใช้ปริมาณน้อย

curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"

2. จัดการแหล่งที่มาและเนื้อหาให้ถูกต้อง

source=local มาจากดัชนี TutuSoo; source=brave คือสำรองจากเว็บเมื่อความครอบคลุมในระบบมีน้อย

• ใช้ url ที่ส่งกลับเพื่อนำทาง อย่าอนุมานที่อยู่ภายนอกจาก id
• เรียก /api/v1/content/{id} เฉพาะผลในระบบที่มี id ไม่ว่าง
• จัดการ 429, หมดเวลา, สถานะออฟไลน์ และผลลัพธ์ว่าง โดยไม่ลองใหม่ไม่จำกัด

3. การแบ่งหน้าและขีดจำกัดทรัพยากร

UI เว็บแสดง 10 ผลต่อหน้าและจำกัดการแบ่งหน้าลึก API จำกัดความยาวคำค้น จำนวนผล และความลึกที่รับได้ เพื่อไม่ให้คำขอเดียวผูกขาดทรัพยากร

• คำค้นจำกัดที่ 512 อักขระ
• limit สูงสุด 100 แนะนำ 10–20
• time_range กรองตามเวลาที่ TutuSoo เก็บ/จัดทำดัชนี ไม่ใช่วันที่เผยแพร่หน้า
• ใช้ exponential backoff แบบมีขอบเขตสำหรับ 429 หรือ 503 เพื่อเลี่ยงพายุ retry