Geliştiriciler · API v1

TopV itibarını entegre et
sitenize, Tebex'inize, Discord'unuza.

Ücretsiz genel API. Gömülebilir SVG rozetler. Açık CORS ile JSON. Anahtar yok, kayıt yok, cezalandırıcı hız sınırı yok.

SVG Rozetler

<img> ile gömülebilir. 8 renk varyantı, sitenizin tasarımıyla otomatik eşleşir.

JSON API

Açık CORS *. Anahtar gerekmez. CDN önbelleği + stale-while-revalidate.

Kararlı

Sürümlü uç noktalar (/api/v1/*). Makul hız sınırı, aşılırsa Retry-After ile 429.

Hızlı başlangıç

SVG Rozetler

HTML

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

Düğmeli oylama widget'ı 400×80. Mağaza ana sayfası için.

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

Uç noktalar

GET

/api/v1/badge/{slug}

SVG rozet 160×32 (içerik üretici). ?color= kabul edilir.

SVG

GET

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

SVG rozet 160×32 (FiveM/RedM sunucu).

SVG

GET

/api/v1/widget/{slug}

Düğmeli oylama widget'ı 400×80. Mağaza ana sayfası için.

SVG

GET

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

Sunucu oylama widget'ı.

SVG

GET

/api/v1/creator/{slug}

Tam içerik üretici verisi: oylar, puanlama, yorumlar, tier, bağlantılar.

JSON

GET

/api/v1/server/{slug}

Tam sunucu verisi.

JSON

GET

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

Oylara göre Top N sıralama.

JSON

GET

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

Tam metin arama (min. 2 karakter).

JSON

Rozet ve widget parametreleri

?color=

Mevcut 8 varyanttan birini zorla. Yoksa, renk TopV profilinin vurgusuyla otomatik olarak eşleşir.

orange

red

rose

coral

gold

violet

sky

mint

Hız sınırları

Badge / widget SVG

IP başına 300 istek/dakika.

JSON creator / server / search

IP başına 60 istek/dakika.

JSON rankings

IP başına 30 istek/dakika (join + sort, daha maliyetli).

Aşım durumunda: yanıt 429 Too Many Requests · Retry-After: 60

Sürümleme

Uzun vadeli uyumluluk için /api/v1/* kullanın. Eski uç noktalar (/api/badge/*, /api/widget/*, /api/public/*) çalışmaya devam eder ancak değişebilir. Kırıcı değişiklik durumunda yeni bir /api/v2 tanıtılacak — v1 değişmeden kalacak.

TopV içerik üreticisi misiniz?

Siteniz için kopyala-yapıştır kodu, dashboard'unuzda zaten önceden oluşturulmuş, slug'ınız önceden doldurulmuş ve 8 renk varyantı canlı önizlemede.

Widgets dashboard'umu aç