Nhà cung cấp

Một nhà cung cấp là một nguồn mà javinfo thu thập và chuẩn hóa. Mỗi lần tìm kiếm sẽ trải rộng ra khắp các nhà cung cấp đã đăng ký và trả về kết quả có cấu trúc đầu tiên, nên một lần gọi cho bạn metadata, magnet và stream mà không cần bạn duy trì các trình thu thập dễ hỏng. Bạn có thể để API tự chọn (fan-out) hoặc ghim đúng nguồn bạn muốn.

Danh sách nhà cung cấp

fanza và dmm là hai cửa hàng DMM + FANZA. Các id truy vấn của chúng là query:fanza, query:dmm, query:missav, query:javdb, query:javdatabase.

Chọn nhà cung cấp

Mặc định: fan-out

Bỏ qua providers và mọi nhà cung cấp đã đăng ký đều là ứng viên. API thử chúng theo thứ tự và nhà cung cấp đầu tiên đáp ứng đầy đủ yêu cầu của bạn sẽ thắng:

FANZA → DMM → missav → javdb → javdatabase

Trên /query, một nhà cung cấp không thể đáp ứng filter/sort của bạn sẽ bị bỏ qua âm thầm và thác nước chuyển sang nhà cung cấp tiếp theo. Trên /movie và /random không có bộ lọc, nên chỉ đơn giản là kết quả đầu tiên thắng. Nhà cung cấp đã trả lời được phản hồi lại dưới dạng source:

{ "q": "SSIS-001", "source": "fanza", "result": { "...": "..." } }

Ghim với providers

Gửi providers để buộc một nguồn cụ thể (hoặc một tập hợp). Nó chấp nhận một mảng hoặc một danh sách phân tách bằng dấu phẩy, có hoặc không có tiền tố query::

curl -s -X POST https://api.javinfo.dev/query \
  -H "x-javinfo-key: $KEY" -H 'content-type: application/json' \
  -d '{ "q": "ABP", "providers": ["javdb"], "sort": "rating" }'

"providers": "javdb", ["fanza","missav"], và "query:javdb" đều hợp lệ. Khi một nhà cung cấp đã ghim không thể đáp ứng yêu cầu trên /query, nó không bị bỏ qua — cuộc gọi thất bại với 422 và một message nêu rõ lý do (một id không xác định là 400). Xem Lỗi.

Việc chọn nhà cung cấp chi phối ba bề mặt:

• /query — ghim, thác nước và khả năng theo từng bộ lọc. Nhà cung cấp nào hỗ trợ filter/sort nào là điểm mấu chốt của hệ thống; xem ma trận khả năng đầy đủ.
• /movie / /random — không có bộ lọc; nhà cung cấp thắng được phản hồi dưới dạng source.
• Máy chủ MCP — các công cụ javinfo-search / javinfo-movie nhận đối số providers riêng của chúng (lưu ý javdb chỉ dành cho movie ở đó).

Các nhà cung cấp

fanza / dmm

Các cửa hàng DMM + FANZA, và là nguồn có cấu trúc phong phú nhất: tất cả các chiều có tên (genre, actress, maker, series, director, label, actor), kết hợp tự do, với giá trị genre/tên bằng tiếng Anh, bộ lọc thời lượng tính theo phút, sort: release, và phân trang. Chỉ danh mục censored — một bộ lọc uncensored sẽ loại trừ chúng.

missav

Bề mặt lọc rộng nhất và là nguồn stream (URL .m3u8). Mọi chiều có tên (thể loại là tiếng Nhật, ví dụ 巨乳), cả khoảng thời lượng và khoảng phát hành, và censored cả hai chiều. Đánh đổi: không có sort (chỉ độ liên quan) và không có phân trang thực sự (luôn trang 1).

javdb

Không có bộ lọc theo từng trường, nhưng có sắp xếp tốt nhất và là nguồn tải xuống. Chỉ có tab censored thô (cả hai chiều), availability (playable / magnets / subtitle / single), và sort phong phú (relevance / release / update / rating). Có phân trang. Hãy ghim nó để lấy magnet và liên kết tải xuống.

javdatabase

Duyệt kho lưu trữ theo một chiều duy nhất — genre, actress, maker, series, director — trong đó chỉ genre + maker kết hợp được (một kho lưu trữ genre ∩ studio). Giá trị tiếng Anh, tự động chuyển thành slug ("S1 NO.1 STYLE" → s1-no-1-style). Censored và uncensored. Có phân trang, mới nhất trước. Tốt cho mô tả và ảnh mẫu.

Tiếp theo

• Lọc — ma trận khả năng theo từng nhà cung cấp đầy đủ và bảng tra cứu nhanh /query.
• Máy chủ MCP — nhà cung cấp dưới dạng đối số công cụ.
• Tài liệu tham khảo API — mọi endpoint kèm playground trực tiếp.