Атрибуция приложений

Добавьте заголовок referer к вызовам API — javinfo заведёт публичную страницу: всего запросов, аккаунты, самый частый провайдер. Приложение появится в рейтинге.

Бесплатно. Вызовы с атрибуцией тарифицируются так же, а заголовки не влияют на лимит. Не отправите — ничего: ни страницы, ни рейтинга, ни записи.

ЗаголовкиКопировать ссылку

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 добавляет запрос. /stats и /health не атрибутируются.

Запись идёт в фоновой очереди после ответа: задержки нет, а сбой Redis не уронит запрос, который уже отработал.

Что сохраняетсяКопировать ссылку

URL нормализуется до origin плюс путь. Query string и фрагмент отбрасываются, корневой путь схлопывается до origin:

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. Себя мы в рейтинг не ставим.
• URL длиннее 500 символов.
• Заголовок без URL. Один только x-javinfo-title не создаёт ничего.

Категории после десятой отсекаются. Фиксированного списка нет: берите то, что описывает приложение: search-ui, discord-bot, cli, scraper, mobile-app.

Страница приложенияКопировать ссылку

Первый запрос с атрибуцией создаёт запись, сразу публичную. Рейтинг сортирует по общему числу запросов. На javinfo.dev/apps/{id} видно:

• Всего запросов за всё время.
• Уникальные аккаунты javinfo, ходившие через ваш URL. Считаются аккаунты, а не вызовы: настоящее число пользователей, а не визиты.
• Разбивка по провайдерам: сколько запросов закрыли FANZA, DMM, javdb, missav, javdatabase или javlibrary. Порядок — в разделе Провайдеры.

Те же данные читаются без ключа:

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

Место в рейтинге зарабатывают, а не покупают. Платные размещения помечены и не дают позицию в этой таблице.

Как убрать приложениеКопировать ссылку

Перестаньте слать заголовок — счётчики перестанут расти, но накопленные цифры останутся. Нужно удалить страницу? Напишите на [email protected] с адреса в том же домене, и мы её удалим.