Développeurs · API v1

Intègre la réputation TopV
dans ton site, Tebex, Discord.

API publique gratuite. Badges SVG embarquables. JSON avec CORS ouvert. Pas de clé, pas de signup, pas de rate-limit punitif.

Badges SVG

Embedables via <img>. 8 variantes de couleur, auto-match avec le design de ton site.

API JSON

CORS * ouvert. Aucune clé requise. Cache CDN + stale-while-revalidate.

Stable

Endpoints versionnés (/api/v1/*). Rate-limit raisonnable, 429 avec Retry-After si dépassé.

Quick start

Badges SVG

HTML

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

Widget vote 400×80 avec bouton. Pour homepage de store.

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

Endpoints

GET

/api/v1/badge/{slug}

Badge SVG 160×32 (createur). ?color= accepté.

SVG

GET

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

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

SVG

GET

/api/v1/widget/{slug}

Widget vote 400×80 avec bouton. Pour homepage de store.

SVG

GET

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

Widget vote serveur.

SVG

GET

/api/v1/creator/{slug}

Data complète créateur : votes, rating, reviews, tier, liens.

JSON

GET

/api/v1/server/{slug}

Data complète serveur.

JSON

GET

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

Top N classement par votes.

JSON

GET

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

Recherche full-text (min. 2 caractères).

JSON

Paramètres badges & widgets

?color=

Force une couleur parmi les 8 variantes disponibles. Si absent, la couleur s'auto-match avec l'accent de la fiche TopV.

orange

red

rose

coral

gold

violet

sky

mint

Rate limits

Badge / widget SVG

300 req/min par IP.

JSON creator / server / search

60 req/min par IP.

JSON rankings

30 req/min par IP (join + sort, plus coûteux).

En cas de dépassement : réponse 429 Too Many Requests · Retry-After: 60

Versioning

Utilise /api/v1/* pour garantir une compatibilité à long terme. Les endpoints legacy (/api/badge/*, /api/widget/*, /api/public/*) restent fonctionnels mais pourront évoluer. En cas de breaking change, un nouveau /api/v2 sera introduit — v1 restera intact.

Tu es créateur TopV ?

Le code à copier-coller pour ton site est déjà pré-généré dans ton dashboard, avec ton slug pré-rempli et les 8 variantes de couleur en live preview.

Ouvrir mon dashboard Widgets