POST /search đang được thay thế bởi hai endpoint: POST /query và POST /movie. Endpoint cũ vẫn hoạt động nhưng không còn được dùng nữa.
Vấn đề với /search là nó làm hai việc khác nhau. Đôi khi nó trả về danh sách kết quả cho tìm kiếm rộng; đôi khi nó trả về một bản ghi duy nhất khi mã chính xác. Sự mơ hồ đó khiến việc viết client có thể dự đoán trở nên khó khăn hơn.
Bây giờ không còn sự mơ hồ:
POST /querytrả về danh sách kết quả ($0.0002/lần gọi). Sử dụng khi bạn có tên diễn viên, tiêu đề một phần hoặc studio. Mỗi kết quả cóid,dvdId,title,covervàreleaseDate.POST /movietrả về một bản ghi chuẩn hóa đầy đủ ($0.001/kết quả). Bodyq+providersgiống nhau, nhưng trả về một kết quả khớp nhất với tất cả các trường.
Định dạng body yêu cầu không thay đổi. Chỉ thay đổi URL. Trường providers hiện cũng chấp nhận chuỗi phân cách bằng dấu phẩy ngoài mảng JSON. Di chuyển chỉ là đổi URL.
Việc tách cũng khắc phục sự không nhất quán về giá. Tìm kiếm rộng rẻ hơn vì trả về ít dữ liệu hơn. Tra cứu phim đầy đủ đắt hơn vì tổng hợp metadata từ nhiều nhà cung cấp. Dù cách nào, bạn chỉ trả tiền cho HTTP 200. Thất bại được miễn phí.
/search hiện đang định tuyến nội bộ đến /query. Nó sẽ bị xóa trong bản phát hành tiếp theo. Để xem đặc tả API đầy đủ, hãy truy cập javinfo.dev/llms.txt.
| Mục tiêu | Endpoint cũ | Endpoint mới |
|---|---|---|
| Truy vấn rộng, muốn danh sách | /search (không dùng nữa) | POST /query |
| Mã chính xác, muốn chi tiết đầy đủ | /search (không dùng nữa) | POST /movie |