Developers
Kết quả web có cấu trúc trong một yêu cầu
Endpoint tìm kiếm công khai hoạt động không cần đăng ký hay API key. Kết quả cục bộ thưa có thể được bổ sung bằng nguồn ngoài có nhãn rõ ràng; nội dung đầy đủ chỉ dành cho kết quả đã lập chỉ mục cục bộ.
1. Thực hiện yêu cầu đầu tiên
q là tham số bắt buộc duy nhất. Bậc công khai không cần header Authorization và phù hợp để đánh giá, dùng lượng thấp.
curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"2. Xử lý nguồn và nội dung đúng cách
source=local đến từ chỉ mục TutuSoo; source=brave là dự phòng web khi phạm vi cục bộ ít.
- Dùng url trả về để điều hướng; đừng bao giờ suy ra địa chỉ ngoài từ id.
- Chỉ gọi /api/v1/content/{id} cho kết quả cục bộ có id không rỗng.
- Xử lý 429, hết thời gian, trạng thái ngoại tuyến và kết quả rỗng mà không thử lại vô hạn.
3. Phân trang và giới hạn tài nguyên
Giao diện web hiển thị 10 kết quả mỗi trang và giới hạn phân trang sâu. API giới hạn độ dài truy vấn, số kết quả và độ sâu chấp nhận để một yêu cầu không độc chiếm tài nguyên.
- Truy vấn giới hạn 512 ký tự.
- limit tối đa 100; khuyến nghị 10–20.
- time_range lọc theo thời gian thu thập/lập chỉ mục của TutuSoo, không theo ngày xuất bản trang.
- Dùng exponential backoff có giới hạn cho phản hồi 429 hoặc 503 để tránh bão thử lại.