Documentație API

Ultima actualizare - septembrie 2026

API-ul public SuperȘcoala este montat la https://scoala.ro/api și răspunde la cereri GET fără autentificare. Catalogul și metadatele sunt publice; conținutul lecțiilor (video, fișe, teste, jocuri) necesită abonament activ. Limita este de 200 de cereri / 5 minute per IP, iar fiecare răspuns include antetele RateLimit, RateLimit-Remaining și RateLimit-Reset.

  • GET /api/public/subjects - lista materiilor, cu titlu, descriere și imagini
  • GET /api/public/courses?subjectId= - clasele (cursurile) dintr-o materie
  • GET /api/public/packages - planurile de abonament, prețurile și beneficiile
  • GET /api/public/sitemap-paths - toate URL-urile canonice publice, în format JSON
  • GET /api/public/autocomplete-lessons?searchTerm= - sugestii de căutare, ca listă de text
  • GET /api/client/subjects/{id} - o materie cu structura ei
  • GET /api/client/lessons?courseId= - lecțiile dintr-o clasă
  • GET /api/client/lessons/{id} - o lecție și metadatele ei
  • GET /api/client/search-lessons?searchTerm= - lecțiile care corespund unui termen căutat
  • POST /api/public/breadcrumbs - denumirile lizibile pentru slug-urile dintr-un URL

Exemplu de cerere:

curl 'https://scoala.ro/api/client/search-lessons?searchTerm=fractii'

Paginile de lecție au forma /{materie}/{clasa}/{capitol}/{lectie} și sunt URL-urile canonice pe care le recomandăm pentru citare.

Serverul MCP răspunde la https://scoala.ro/api/mcp prin Streamable HTTP (JSON-RPC 2.0 peste POST), fără autentificare, doar pentru citire, cu maxim 200 de cereri / 5 minute per IP. În Claude îl adaugi din Settings → Connectors → Add custom connector, lipind acest URL; în ChatGPT din Settings → Connectors, cu developer mode activat, prin „add MCP server”.

  • search_lessons - caută lecții după un termen și returnează URL-urile canonice
  • list_subjects - toate materiile, fiecare cu clasele din ea
  • get_course_outline - capitolele și lecțiile unei clase, în ordinea din programă
  • get_lesson - o lecție cu metadatele publice și lecțiile următoare
  • list_packages - planurile de abonament, prețurile și beneficiile incluse
  • list_teachers - profesorii SuperȘcoala, cu prezentare scurtă și biografie
  • get_platform_info - informații despre platformă, abonament și contact