Açık veri
Voicendex Public API
Yayınlı claim’ler, teknik skorlar ve taksonomi — kanıtsız veri dönülmez. Sürüm 1.1.0.
Atıf zorunluluğu
Bu API’den üretilen her kamuya açık rapor, makale veya ürün arayüzünde şu atıf görünür olmalıdır:
«Data provided by Voicendex»
Her JSON yanıtında meta.attribution ve X-CX-Attribution header’ı vardır. Metodoloji: /metodoloji.
Kimlik doğrulama & kota
- Anonim: 60 istek/dakika / IP — anahtar gerekmez.
- API key: header
X-Api-Key: cxk_…veyaAuthorization: Bearer cxk_…. Varsayılan 300/dk (admin ayarlar). - Anahtarlar admin panelinden üretilir (/admin#api). Platform ücretsizdir; ücretli kota şimdilik yok.
Uç noktalar
GET /api/v1/products
Aktif ürün listesi + özet sayaçlar
GET /api/v1/products/{slug}
Ürün, yayınlı claim’ler, lab özeti
GET /api/v1/products/{slug}/scores
Teknik skor + kategori kırılımı
GET /api/v1/taxonomy
Aktif taksonomi ağacı
GET /api/v1/openapi
OpenAPI 3 spec
GET /api/v1/mcp
İnce MCP araç kataloğu (keşif)
Örnek
curl -sS "http://localhost:3000/api/v1/products/vapi-voice/scores" \ -H "X-Api-Key: cxk_…" | jq .scores.overall,.meta.attribution
Ürün slug’ları için GET /api/v1/products.
Kapsam dışı
- GraphQL — şimdilik REST yeterli
- Tam MCP stdio/SSE — ince keşif kataloğu var
- in_review / retired claim’ler — asla dönülmez
- Vitrin / kör tadım / topluluk puanı — teknik skora karışmaz