Chuyển đến nội dung
javinfo

Ghi nhận ứng dụng

Gửi một header và ứng dụng của bạn vào bảng xếp hạng công khai javinfo: lượt gọi, người dùng, tỉ lệ nhà cung cấp. Miễn phí, tùy chọn, một phút.

Thêm header referer vào lời gọi API. javinfo giữ trang công khai: tổng lượt gọi, tài khoản, nhà cung cấp trả lời nhiều nhất. Ứng dụng của bạn nằm trong bảng xếp hạng.

Miễn phí. Lời gọi có ghi nhận tính tiền như nhau và header không đụng giới hạn tần suất. Không gửi: không trang, không hạng, không bản ghi.

Các header

HeaderBắt buộcTác dụng
HTTP-ReferercóURL ứng dụng của bạn. Đây chính là danh tính của ứng dụng. Không URL thì không có trang.
Referer–Trình duyệt tự gắn. Dùng làm phương án dự phòng khi thiếu HTTP-Referer.
x-javinfo-titlekhôngTên hiển thị. Mặc định là hostname trong URL của bạn.
x-javinfo-categorieskhôngCác thẻ cách nhau bằng dấu phẩy, tối đa 10. Tự chuyển thành chữ thường.

HTTP-Referer là quy ước OpenRouter: Referer thuần là header bị cấm trong trình duyệt, JavaScript không đặt được. Từ máy chủ, cả hai đều được. Từ trình duyệt, Referer tự có; phần còn lại bạn thêm.

cURL
curl "https://api.javinfo.dev/movie?q=SSIS-001" \
  -H "x-javinfo-key: jvi_your_key_here" \
  -H "HTTP-Referer: https://myapp.example.com" \
  -H "x-javinfo-title: My App" \
  -H "x-javinfo-categories: search-ui, metadata"
JavaScript (fetch)
const res = await fetch('https://api.javinfo.dev/query?q=SSIS', {
  headers: {
    'x-javinfo-key': 'jvi_your_key_here',
    'HTTP-Referer': 'https://myapp.example.com',
    'x-javinfo-title': 'My App',
  },
});

Đặt một lần trong header mặc định của HTTP client rồi quên đi.

URL bạn gửi thành liên kết công khai trên javinfo.dev. Gửi trang bạn muốn người ta bấm vào, đừng gửi trang quản trị hay host staging.

Những endpoint được tính

/movie, /query và /random. Mỗi lời gọi thành công với referer hợp lệ cộng một lượt. /stats và /health không được ghi nhận.

Ghi nhận chạy trên hàng đợi nền sau khi phản hồi đi: không thêm độ trễ, và Redis trục trặc không làm hỏng lời gọi đã thành công.

Những gì được lưu

URL chuẩn hóa thành origin cộng path. Query string và fragment bị bỏ; path gốc thu lại thành origin:

https://myapp.example.com/?ref=hn      →  https://myapp.example.com
https://myapp.example.com/search?q=x   →  https://myapp.example.com/search

Path khác nhau là ứng dụng khác nhau. Chọn một URL chuẩn, không thì lưu lượng tách thành hai dòng.

Tiêu đề và danh mục chỉ cập nhật khi bạn gửi; bỏ qua thì giá trị lần trước giữ nguyên.

Những gì bị bỏ qua

Ghi nhận bị bỏ lặng lẽ; lời gọi API vẫn thành công.

  • Không có HTTP-Referer lẫn Referer.
  • Referer không phải URL hợp lệ.
  • Bất cứ thứ gì không phải http hay https. Không file://, không scheme tự chế.
  • localhost, 127.0.0.1, ::1. Môi trường dev cục bộ không làm bẩn bảng xếp hạng.
  • javinfo.dev và app.javinfo.dev. Chúng tôi không tự xếp hạng mình.
  • URL dài hơn 500 ký tự.
  • Tiêu đề mà không có URL. x-javinfo-title đứng một mình không tạo ra gì cả.

Danh mục từ cái thứ 11 bị cắt. Không có danh sách cố định; dùng từ nào mô tả đúng ứng dụng: search-ui, discord-bot, cli, scraper, mobile-app.

Trang ứng dụng của bạn

Lời gọi có ghi nhận đầu tiên tạo mục và lên sóng ngay. Bảng xếp hạng sắp theo tổng lượt gọi. javinfo.dev/apps/{id} cho bạn:

  • Tổng số lượt gọi từ trước đến nay.
  • Số tài khoản javinfo khác nhau từng gọi qua URL của bạn. Đếm theo tài khoản, không theo lượt: người dùng thật, không phải lượt truy cập đội lốt.
  • Tỉ lệ nhà cung cấp: bao nhiêu truy vấn được FANZA, DMM, javdb, missav, javdatabase hay javlibrary trả lời. Thứ tự trong Nhà cung cấp.

Dữ liệu này đọc được mà không cần khóa:

curl "https://api.javinfo.dev/v1/apps/rankings?limit=20"
curl "https://api.javinfo.dev/v1/apps/{id}"

Thứ hạng giành được, không mua được. Vị trí trả phí trên javinfo.dev được ghi rõ và không mua được chỗ trong bảng này.

Gỡ ứng dụng khỏi bảng

Ngừng gửi header thì mục ngừng tăng; con số cũ vẫn còn. Muốn xóa hẳn trang? Gửi mail tới [email protected] từ cùng tên miền, chúng tôi sẽ xóa.

Trong trang này