Dezvoltatori · API v1

Integrează reputația TopV
în site-ul tău, Tebex, Discord.

API public gratuit. Badge-uri SVG încorporabile. JSON cu CORS deschis. Fără cheie, fără înregistrare, fără rate-limit punitiv.

Badge-uri SVG

Încorporabile prin <img>. 8 variante de culoare, auto-match cu designul site-ului tău.

API JSON

CORS * deschis. Nu este necesară cheia. Cache CDN + stale-while-revalidate.

Stabil

Endpoint-uri versionate (/api/v1/*). Rate-limit rezonabil, 429 cu Retry-After dacă este depășit.

Start rapid

Badge-uri SVG

HTML

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

Widget vot 400×80 cu buton. Pentru pagina de pornire a magazinului.

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

Endpoint-uri

GET

/api/v1/badge/{slug}

Badge SVG 160×32 (creator). ?color= acceptat.

SVG

GET

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

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

SVG

GET

/api/v1/widget/{slug}

Widget vot 400×80 cu buton. Pentru pagina de pornire a magazinului.

SVG

GET

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

Widget vot server.

SVG

GET

/api/v1/creator/{slug}

Date complete creator: voturi, rating, recenzii, tier, linkuri.

JSON

GET

/api/v1/server/{slug}

Date complete server.

JSON

GET

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

Clasament Top N după voturi.

JSON

GET

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

Căutare full-text (min. 2 caractere).

JSON

Parametri badge și widget

?color=

Forțează una dintre cele 8 variante disponibile. Dacă lipsește, culoarea se auto-match cu accentul profilului TopV.

orange

red

rose

coral

gold

violet

sky

mint

Limite de rată

Badge / widget SVG

300 cereri/min per IP.

JSON creator / server / search

60 cereri/min per IP.

JSON rankings

30 cereri/min per IP (join + sort, mai costisitor).

La depășire: răspuns 429 Too Many Requests · Retry-After: 60

Versiune

Folosește /api/v1/* pentru compatibilitate pe termen lung. Endpoint-urile legacy (/api/badge/*, /api/widget/*, /api/public/*) rămân funcționale, dar pot evolua. În caz de breaking change, va fi introdus un nou /api/v2 — v1 va rămâne intact.

Ești creator TopV?

Codul de copiat-lipit pentru site-ul tău este deja pre-generat în dashboard-ul tău, cu slug-ul pre-completat și cele 8 variante de culoare în previzualizare live.

Deschide dashboard-ul meu Widgets