アプリ帰属
ヘッダーを1つ送ると、アプリが javinfo の公開ランキングに載ります。リクエスト数、ユーザー数、プロバイダー内訳つき。無料、任意、1分。
API 呼び出しに referer ヘッダーを付けると、javinfo がアプリの公開ページを維持します。累計 リクエスト数、アカウント数、プロバイダー内訳。 ランキングに載ります。
無料です。帰属付きの呼び出しも課金は同じ、レート制限にも影響しません。付けなければ 何も起きません。ページも順位も記録も。
ヘッダー
| ヘッダー | 必須 | 役割 |
|---|---|---|
HTTP-Referer | はい | アプリの URL。これがアプリの identity です。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',
},
});既定ヘッダーに一度設定すれば、あとは忘れて構いません。
送った URL は javinfo.dev 上の公開リンクになります。人に開いてほしいページを送ってください。 社内の管理画面やステージングではなく。
対象エンドポイント
/movie、/query、/random。有効な referer 付きの成功呼び出しごとに、累計リクエストが
1つ増えます。/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 を1つ決めて使い続けてください。さもないとランキングで 2行に分かれます。
タイトルとカテゴリーは送ったときだけ更新。省略すれば前回の値が残ります。
無視される条件
いずれも帰属は黙って破棄。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単体では何も作られません。
11個目以降のカテゴリーは切り捨て。固定の一覧はないので、アプリを説明する語で
構いません。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] にメールを。削除します。