Разработчики · API v1

Интегрируйте репутацию TopV
в ваш сайт, Tebex, Discord.

Бесплатный публичный API. Встраиваемые SVG-значки. JSON с открытым CORS. Без ключа, без регистрации, без штрафного rate-limit.

SVG-значки

Встраиваются через <img>. 8 цветовых вариантов, авто-подбор под дизайн вашего сайта.

JSON API

Открытый CORS *. Ключ не требуется. CDN-кэш + stale-while-revalidate.

Стабильно

Версионированные endpoint (/api/v1/*). Разумный rate-limit, 429 с Retry-After при превышении.

Быстрый старт

SVG-значки
HTML
<a href="https://topv.gg/creators/quasar-store">
  <img src="https://topv.gg/api/v1/badge/quasar-store" alt="TopV" />
</a>
Вотинг-виджет 400×80 с кнопкой. Для homepage магазина.
HTML
<a href="https://topv.gg/creators/quasar-store">
  <img src="https://topv.gg/api/v1/widget/quasar-store" alt="Vote on TopV" />
</a>
JSON API
JavaScript
const res = await fetch("https://topv.gg/api/v1/creator/quasar-store");
const data = await res.json();
console.log(data.votes, data.rating, data.reviews);

Endpoint

GET
/api/v1/badge/{slug}
SVG-значок 160×32 (создатель). ?color= принимается.
SVG
GET
/api/v1/badge/server/{slug}
SVG-значок 160×32 (сервер FiveM/RedM).
SVG
GET
/api/v1/widget/{slug}
Вотинг-виджет 400×80 с кнопкой. Для homepage магазина.
SVG
GET
/api/v1/widget/server/{slug}
Вотинг-виджет сервера.
SVG
GET
/api/v1/creator/{slug}
Полные данные создателя: голоса, рейтинг, отзывы, tier, ссылки.
JSON
GET
/api/v1/server/{slug}
Полные данные сервера.
JSON
GET
/api/v1/rankings?type=creators|servers&limit=10
Топ N рейтинг по голосам.
JSON
GET
/api/v1/search?q=query&type=creators|servers|all
Полнотекстовый поиск (мин. 2 символа).
JSON

Параметры badge и widget

?color=

Принудительно установить один из 8 вариантов. Если отсутствует, цвет автоматически подбирается под акцент профиля TopV.

orange
red
rose
coral
gold
violet
sky
mint

Ограничения частоты

Badge / widget SVG
300 запросов/мин на IP.
JSON creator / server / search
60 запросов/мин на IP.
JSON rankings
30 запросов/мин на IP (join + sort, тяжелее).

При превышении: ответ 429 Too Many Requests · Retry-After: 60

Версионирование

Используйте /api/v1/* для долгосрочной совместимости. Legacy endpoint (/api/badge/*, /api/widget/*, /api/public/*) остаются функциональными, но могут эволюционировать. При breaking change будет введён новый /api/v2 — v1 останется нетронутым.

Вы создатель на TopV?

Код для копирования и вставки на ваш сайт уже предварительно сгенерирован в вашем dashboard, с вашим slug, предварительно заполненным, и 8 цветовыми вариантами в живом предпросмотре.

Открыть мой Widgets-дашборд