API Publike v1
Të dhënat e administratës publike, në duart tuaja
API publike për gazetarë, studentë, OJQ dhe zhvillues. Aksesoni vlerësimet, raportet dhe statistikat e platformës — falas.
Endpoints
GET
/api/public/v1/institutionsListo institucionet me filtra (city, category, q)
GET
/api/public/v1/reviewsVlerësimet publike, filtrueshme sipas institucionit
GET
/api/public/v1/statsStatistika përmbledhëse të platformës
Shembuj
curl -H "Authorization: Bearer vsp_YOUR_KEY" \
"https://vlereso.ks/api/public/v1/institutions?city=Prishtin%C3%AB"Autentikimi
Mund të dërgosh çelësin në tri mënyra:
Authorization: Bearer vsp_...(rekomandohet)X-API-Key: vsp_...?key=vsp_...(jo për kërkesa publike)
Pa çelës: 20 kërkesa/min për IP. Çdo përgjigje përfshin headersX-RateLimit-Remaining dheX-RateLimit-Reset.