Programiści · API v1

Zintegruj reputację TopV
w swojej stronie, Tebex, Discord.

Darmowe publiczne API. Osadzane badge SVG. JSON z otwartym CORS. Bez klucza, bez rejestracji, bez karnego rate-limitu.

Badge SVG

Osadzane przez <img>. 8 wariantów kolorów, auto-match z designem twojej strony.

API JSON

Otwarty CORS *. Klucz nie jest wymagany. Cache CDN + stale-while-revalidate.

Stabilne

Wersjonowane endpointy (/api/v1/*). Rozsądny rate-limit, 429 z Retry-After przy przekroczeniu.

Szybki start

Badge SVG

HTML

<a href="https://topv.gg/creators/quasar-store">
  <img src="https://topv.gg/api/v1/badge/quasar-store" alt="TopV" />
</a>

Widget głosowania 400×80 z przyciskiem. Dla strony głównej sklepu.

HTML

<a href="https://topv.gg/creators/quasar-store">
  <img src="https://topv.gg/api/v1/widget/quasar-store" alt="Vote on TopV" />
</a>

API JSON

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);

Endpointy

GET

/api/v1/badge/{slug}

Badge SVG 160×32 (twórca). ?color= akceptowane.

SVG

GET

/api/v1/badge/server/{slug}

Badge SVG 160×32 (serwer FiveM/RedM).

SVG

GET

/api/v1/widget/{slug}

Widget głosowania 400×80 z przyciskiem. Dla strony głównej sklepu.

SVG

GET

/api/v1/widget/server/{slug}

Widget głosowania serwera.

SVG

GET

/api/v1/creator/{slug}

Pełne dane twórcy: głosy, ocena, recenzje, tier, linki.

JSON

GET

/api/v1/server/{slug}

Pełne dane serwera.

JSON

GET

/api/v1/rankings?type=creators|servers&limit=10

Ranking Top N według głosów.

JSON

GET

/api/v1/search?q=query&type=creators|servers|all

Wyszukiwanie pełnotekstowe (min. 2 znaki).

JSON

Parametry badge i widget

?color=

Wymusza jedną z 8 dostępnych wariantów. Jeśli brak, kolor auto-match z accent profilu TopV.

orange

red

rose

coral

gold

violet

sky

mint

Limity szybkości

Badge / widget SVG

300 zapytań/min na IP.

JSON creator / server / search

60 zapytań/min na IP.

JSON rankings

30 zapytań/min na IP (join + sort, droższe).

W przypadku przekroczenia: odpowiedź 429 Too Many Requests · Retry-After: 60

Wersjonowanie

Użyj /api/v1/* dla długoterminowej kompatybilności. Legacy endpointy (/api/badge/*, /api/widget/*, /api/public/*) pozostają funkcjonalne, ale mogą ewoluować. W przypadku breaking change pojawi się nowy /api/v2 — v1 pozostanie nienaruszone.

Jesteś twórcą TopV?

Kod do wklejenia na twoją stronę jest już wstępnie wygenerowany w twoim panelu, z wypełnionym slugiem i 8 wariantami kolorów w podglądzie na żywo.

Otwórz mój dashboard Widgets