アプリ帰属

API 呼び出しに referer ヘッダーを付けると、javinfo があなたのアプリ用の公開ページを持ち始めます。 累計リクエスト数、そのアプリ経由で呼んでいるアカウント数、どのプロバイダーが最も多く応答したか。 アプリは javinfo.dev のランキングに掲載されます。

費用はかかりません。帰属付きの呼び出しは帰属なしとまったく同じ課金で、これらのヘッダーはレート制限 にも影響しません。付けなければ何も起きません。ページも順位も記録もなしです。

ヘッダー

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 クライアントの既定ヘッダーに一度設定すれば、あとは忘れていて大丈夫です。

対象エンドポイント

/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}"

ランキングは獲得するものであって、買えるものではありません。有料枠は javinfo.dev の別の場所にあり、 その旨が明示されます。この表の順位を金で買うことはできません。

アプリを削除する

ヘッダーを送るのをやめればエントリーの数字は増えなくなりますが、過去の数値は残ります。ページごと 消したい場合は、URL と同じドメインのアドレスから [email protected] にメールしてください。削除します。