/api · v1.spec
Public REST API,
tüm review JSON.
VBS review içeriğini JSON üzerinden çek, skor rozetini SVG veya JS embed ile sitene yapıştır. Auth yok, sadece GET, CORS açık, IP başına 60 req/dk.
//
REST endpoints
06 route
GET
/api/
Endpoint listesi (bu sayfanın JSON karşılığı).
GET
/api/projects
Tüm yayınlanmış review'lar (özet). Query: limit (1-100), kategori (web/app/oyun), tag (slug), order (newest/oldest/score_desc/score_asc).
GET
/api/projects/{slug}
Tek review — özet + review_html + recommendations[] ile.
GET
/api/articles
Tüm haberler. Query: limit, tag.
GET
/api/articles/{slug}
Tek haber — özet + content_html ile.
GET
/api/tags
Tüm etiketler.
//
örnekler
curl + js
bash
curl https://vibebuiltscore.com/api/projects?kategori=web&order=score_desc&limit=3 # Tek review: curl https://vibebuiltscore.com/api/projects/notly
javascript
const res = await fetch('https://vibebuiltscore.com/api/projects?limit=5');
const { data, total } = await res.json();
console.log(data.map(p => `${p.title} · ${p.score}`));
//
rate limit + cors
throttle policy
IP başına dakikada 60 istek. Aşılırsa 429 Too Many Requests + Retry-After header döner.
CORS * açık — public tüketim için browser'dan direkt çağrılabilir.