Atribusi aplikasi

Tambahkan header referer ke panggilan API-mu dan javinfo mulai menyimpan halaman publik untuk aplikasimu: total permintaan, berapa akun yang memanggil lewat aplikasi itu, provider mana yang paling sering menjawab. Aplikasimu muncul di peringkat javinfo.dev.

Gratis. Panggilan yang beratribusi ditagih persis sama dengan yang tanpa atribusi, dan header ini tidak menyentuh rate limit-mu. Kalau tidak dikirim, tidak terjadi apa-apa: tanpa halaman, tanpa peringkat, tanpa catatan.

Header-nya

HTTP-Referer mengikuti konvensi OpenRouter, dan itu ada karena Referer biasa termasuk header terlarang di browser: JavaScript tidak bisa menyetelnya. Dari server, keduanya bisa kamu set. Dari browser, Referer sudah otomatis dan sisanya kamu tambahkan sendiri.

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"

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',
  },
});

Set sekali di default header HTTP client-mu, lalu lupakan.

Endpoint mana yang dihitung

/movie, /query, dan /random. Setiap panggilan sukses ke salah satunya dengan referer yang valid menambah satu permintaan ke total aplikasimu. /stats dan /health tidak dihitung.

Pencatatan berjalan di antrean latar belakang setelah respons sudah dikirim, jadi tidak menambah latensi, dan gangguan Redis tidak akan pernah menggagalkan permintaan yang sudah berhasil.

Apa yang disimpan

URL dinormalisasi menjadi origin plus path. Query string dan fragment dibuang, dan path root menyusut jadi origin saja:

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

Path berbeda berarti aplikasi berbeda. Pilih satu URL kanonik dan konsisten pakai itu, kalau tidak trafikmu terbelah jadi dua baris di peringkat.

Judul dan kategori hanya diperbarui saat kamu mengirimnya. Kalau tidak dikirim, nilai terakhir tetap dipakai.

Apa yang diabaikan

Pada semua kasus ini atribusi dibuang diam-diam. Panggilan API-nya sendiri tetap sukses.

• Tidak ada HTTP-Referer maupun Referer.
• Referer yang bukan URL valid.
• Apa pun selain http atau https. Tidak ada file://, tidak ada skema kustom.
• localhost, 127.0.0.1, ::1. Development lokal tidak akan mengotori peringkat.
• javinfo.dev dan app.javinfo.dev. Kami tidak memeringkat diri sendiri.
• URL lebih dari 500 karakter.
• Judul tanpa URL. x-javinfo-title sendirian tidak membuat apa pun.

Kategori setelah yang kesepuluh dipotong. Tidak ada daftar kategori baku, jadi pakai apa saja yang menggambarkan aplikasimu: search-ui, discord-bot, cli, scraper, mobile-app.

Halaman aplikasimu

Permintaan beratribusi pertama membuat entri dan langsung tayang. Setelah itu peringkat menampilkan aplikasimu urut berdasarkan total permintaan, dan membuka javinfo.dev/apps/{id} memberimu:

• Total permintaan sepanjang waktu.
• Jumlah akun javinfo unik yang pernah memanggil lewat URL-mu. Dihitung per akun, bukan per panggilan, jadi ini benar-benar hitungan pengguna, bukan hitungan kunjungan berlabel pengguna.
• Rincian provider: berapa banyak pencarianmu dijawab FANZA, DMM, javdb, missav, javdatabase, atau javlibrary. Lihat Provider untuk memahami urutannya.

Data yang sama bisa dibaca tanpa API key:

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

Peringkat itu diraih, bukan dibeli. Slot berbayar ada di bagian lain javinfo.dev dan diberi label jelas; slot itu tidak bisa membeli posisi di tabel ini.

Menghapus aplikasimu

Berhenti mengirim header dan entrimu berhenti bertambah, walau angka historisnya tetap ada. Mau halamannya hilang sama sekali? Kirim email ke [email protected] dari alamat dengan domain yang sama seperti URL-nya, nanti kami hapus.