開発者 · API v1

TopVレピュテーションを統合
あなたのサイト、Tebex、Discordに。

無料の公開API。埋め込み可能なSVGバッジ。オープンCORSのJSON。キー不要、登録不要、厳しいレート制限なし。

SVGバッジ

<img>で埋め込み可能。8色バリアント、サイトデザインと自動マッチ。

JSON API

オープンCORS *。キー不要。CDNキャッシュ + stale-while-revalidate。

安定

バージョン管理されたエンドポイント (/api/v1/*)。合理的なレート制限、超過時は429とRetry-After。

クイックスタート

SVGバッジ

HTML

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

ボタン付き投票ウィジェット 400×80。ストアホームページ用。

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

エンドポイント

GET

/api/v1/badge/{slug}

SVGバッジ 160×32（クリエイター）。?color= 受け入れ。

SVG

GET

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

SVGバッジ 160×32（FiveM/RedMサーバー）。

SVG

GET

/api/v1/widget/{slug}

ボタン付き投票ウィジェット 400×80。ストアホームページ用。

SVG

GET

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

サーバー投票ウィジェット。

SVG

GET

/api/v1/creator/{slug}

完全なクリエイターデータ：投票、評価、レビュー、ティア、リンク。

JSON

GET

/api/v1/server/{slug}

完全なサーバーデータ。

JSON

GET

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

投票によるトップNランキング。

JSON

GET

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

全文検索（最低2文字）。

JSON

バッジとウィジェットのパラメータ

?color=

8つの利用可能なバリアントから1つを強制。指定しない場合、色はTopVプロファイルのアクセントと自動的に一致します。

orange

red

rose

coral

gold

violet

sky

mint

レート制限

Badge / widget SVG

IPあたり300リクエスト/分。

JSON creator / server / search

IPあたり60リクエスト/分。

JSON rankings

IPあたり30リクエスト/分（join+sort、重い）。

超過時: レスポンス 429 Too Many Requests · Retry-After: 60

バージョニング

長期互換性のため /api/v1/* を使用してください。レガシーエンドポイント (/api/badge/*, /api/widget/*, /api/public/*) は機能し続けますが、進化する可能性があります。breaking changeの場合、新しい /api/v2 が導入されます — v1 は無傷のままです。

TopVクリエイターですか？

あなたのサイトに貼り付けるコードは既にダッシュボードで事前生成されており、スラッグが事前入力され、8つのカラーバリアントがライブプレビューで表示されます。

Widgetsダッシュボードを開く