개발자 · API v1

TopV 평판 통합
당신의 사이트, Tebex, Discord에.

무료 공용 API. 임베드 가능한 SVG 배지. 개방된 CORS의 JSON. 키 불필요, 가입 불필요, 가혹한 rate-limit 없음.

SVG 배지

<img>로 임베드. 8가지 색상 변형, 사이트 디자인과 자동 매칭.

JSON API

개방된 CORS *. 키 불필요. CDN 캐시 + stale-while-revalidate.

안정

버전 관리된 엔드포인트 (/api/v1/*). 합리적인 rate-limit, 초과 시 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}

완전한 크리에이터 데이터: 투표, 평점, 리뷰, tier, 링크.

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가지 변형 중 하나를 강제합니다. 없으면 색상이 TopV 프로필의 accent와 자동으로 일치합니다.

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 크리에이터이신가요?

당신의 사이트에 복사-붙여넣기할 코드는 이미 대시보드에 사전 생성되어 있으며, slug가 미리 채워져 있고 8가지 색상 변형이 라이브 미리보기로 표시됩니다.

내 위젯 대시보드 열기