Sviluppatori · API v1

Integra la reputazione TopV
nel tuo sito, Tebex, Discord.

API pubblica gratuita. Badge SVG incorporabili. JSON con CORS aperto. Nessuna chiave, nessuna registrazione, nessun rate-limit punitivo.

Badge SVG

Incorporabili tramite <img>. 8 varianti di colore, auto-match con il design del tuo sito.

API JSON

CORS * aperto. Nessuna chiave richiesta. Cache CDN + stale-while-revalidate.

Stabile

Endpoint versionati (/api/v1/*). Rate-limit ragionevole, 429 con Retry-After se superato.

Avvio rapido

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 voto 400×80 con pulsante. Per homepage del negozio.

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

GET

/api/v1/badge/{slug}

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

SVG

GET

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

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

SVG

GET

/api/v1/widget/{slug}

Widget voto 400×80 con pulsante. Per homepage del negozio.

SVG

GET

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

Widget voto server.

SVG

GET

/api/v1/creator/{slug}

Dati completi creator: voti, valutazione, recensioni, tier, link.

JSON

GET

/api/v1/server/{slug}

Dati completi server.

JSON

GET

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

Classifica Top N per voti.

JSON

GET

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

Ricerca full-text (min. 2 caratteri).

JSON

Parametri badge e widget

?color=

Forza una delle 8 varianti disponibili. Se assente, il colore auto-match con l'accento del profilo TopV.

orange

red

rose

coral

gold

violet

sky

mint

Limiti di tasso

Badge / widget SVG

300 richieste/min per IP.

JSON creator / server / search

60 richieste/min per IP.

JSON rankings

30 richieste/min per IP (join + sort, più costose).

In caso di superamento: risposta 429 Too Many Requests · Retry-After: 60

Versionamento

Usa /api/v1/* per compatibilità a lungo termine. Gli endpoint legacy (/api/badge/*, /api/widget/*, /api/public/*) rimangono funzionanti ma possono evolversi. In caso di breaking change, sarà introdotto un nuovo /api/v2 — v1 rimarrà intatto.

Sei un creator TopV?

Il codice da copiare e incollare per il tuo sito è già pre-generato nel tuo dashboard, con il tuo slug precompilato e le 8 varianti di colore in anteprima live.

Apri il mio dashboard Widgets