应用归属
加一个请求头，应用就会出现在 javinfo 公开榜单上：请求数、用户数、数据源分布。免费、可选，一分钟。
API 调用带上 referer 请求头，javinfo 就会为应用维护公开页面：累计请求数、调用账号数、最常 作答的数据源。应用出现在 榜单。
免费。计费不变，请求头也不影响速率限制。不发就什么都没有：没有页面、排名、记录。
请求头
| 请求头 | 必填 | 作用 |
|---|---|---|
HTTP-Referer | 是 | 你的应用 URL。它就是应用的身份。没有 URL，就没有应用页面。 |
Referer | – | 浏览器会自动带上。HTTP-Referer 缺失时作为兜底。 |
x-javinfo-title | 否 | 显示名称。默认取 URL 的主机名。 |
x-javinfo-categories | 否 | 逗号分隔的标签，最多 10 个。会自动转成小写。 |
HTTP-Referer 沿用 OpenRouter 的约定：浏览器禁止修改
Referer（禁止修改的请求头），
JavaScript 设不了。服务端两者都能设；浏览器自动带上 Referer，其余自己加。
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',
},
});在 HTTP 客户端默认请求头里设一次，然后忘掉。
你发送的 URL 会成为 javinfo.dev 上的公开链接。填希望别人点开的页面，不要填内部后台或测试环境。
哪些端点会计入
/movie、/query 和 /random。带有效 referer 的成功调用各加一次请求。/stats 和
/health 不计入。
记录由后台队列在响应发出后进行：不增加延迟，Redis 抖动也不会让已成功的请求失败。
会存下什么
URL 归一化为「源 + 路径」。查询字符串和片段丢弃，根路径收敛为源：
https://myapp.example.com/?ref=hn → https://myapp.example.com
https://myapp.example.com/search?q=x → https://myapp.example.com/search不同路径算不同应用。选定一个规范 URL，否则流量拆成两行。
标题和分类只在你发送时更新，否则沿用上次值。
什么会被忽略
归属会被静默丢弃，API 调用照常成功。
- 既没有
HTTP-Referer也没有Referer。 - referer 不是合法 URL。
- 不是
http或https。不接受file://或自定义协议。 localhost、127.0.0.1、::1。本地开发不会污染榜单。javinfo.dev和app.javinfo.dev。我们不给自己排名。- 超过 500 个字符的 URL。
- 只有标题没有 URL。单独的
x-javinfo-title什么也创建不了。
超过 10 个的分类截断。没有固定清单，用能描述你应用的词：search-ui、
discord-bot、cli、scraper、mobile-app。
你的应用页面
第一次带归属的请求创建条目并立即上线。榜单按累计请求数排序。javinfo.dev/apps/{id} 显示：
- 累计请求数。
- 通过你的 URL 调用过的 javinfo 账号数，按账号去重：真实用户数，不是披着用户数外衣的访问数。
- 数据源分布：查询分别由 FANZA、DMM、javdb、missav、javdatabase 或 javlibrary 回答了 多少次。顺序见数据源。
同样数据不用密钥也能读：
curl "https://api.javinfo.dev/v1/apps/rankings?limit=20"
curl "https://api.javinfo.dev/v1/apps/{id}"榜单只能挣，不能买。付费位有明确标注，买不到这张表的名次。
移除你的应用
不再发送请求头，条目停止增长，历史数字保留。想删掉页面？用与该 URL 同域名的邮箱写信给 [email protected]，我们会删除。