Folosește catalogul în aplicații
Un API public, fără cheie, pentru căutarea și preluarea fișelor. Răspunsurile conțin metadatele catalogului, nu fișierele furnizorilor.
curl 'https://mariuscomper.uk/cunoastere-deschisa/api/resources?q=scoli&limit=100'Consolă interactivă API (Live Playground)
Construiește și testează interogări în timp real direct împotriva endpoint-ului /api/resources, cu previzualizare a răspunsului și generare instantă de fragmente de cod.
curl -s 'https://mariuscomper.uk/cunoastere-deschisa/api/resources?limit=25' | jq .// Apasă pe «Execută interogarea» pentru a apela live API-ul.Caută și filtrează
GET /api/resources acceptă q (cel mult 200 de caractere), topic, collection, type, rights, status, api=true și access. Căutarea este bilingvă, fără diferențe între litere cu și fără diacritice; include sinonime uzuale. Termenii rămași după eliminarea cuvintelor de legătură trebuie să se regăsească toți. Un termen fără rezultate nu dovedește absența datelor din România.
Paginare și export
limit are valoarea implicită 25 și maximum 100. offset începe de la 0. total arată câte fișe corespund selecției, returned câte sunt în pagină, iar next oferă pagina următoare sau null. format=csv exportă aceeași pagină; pentru toate cele 85 de fișe folosește limit=100. JSON include descrieri în ambele limbi.
Identificatori și legături
GET /api/resources/{id} întoarce o fișă, iar GET /api/resources/{id}/related oferă sugestii editoriale. Aceste legături nu dovedesc integrarea tehnică și nu autorizează combinarea licențelor. Identificatorii sunt păstrați între ediții; câmpurile noi pot fi adăugate.
Cum interpretezi dovezile
sourceStatus=verified-direct indică o pagină sau documentație consultată. editorialReviewDate este data examinării; lastDatasetUpdate este actualizarea declarată de sursă, când este cunoscută. accessPoints[].testedAt indică verificarea unui exemplu, nu un audit complet. null înseamnă necunoscut. Păstrează limitations, verificationNote, license și licenseUrl când preiei o fișă.
Reutilizare și limite
Metadatele editoriale originale ale acestui catalog pot fi reutilizate sub CC BY 4.0, cu atribuirea „Cunoaștere deschisă România — Marius Comper” și un link către catalog. Resursele citate își păstrează propriile drepturi. API-ul este destinat citirii, fără garanție de disponibilitate sau actualizare continuă. Salvează răspunsurile când ai nevoie de rezultate reproductibile.
Erori și acces din browser
Parametrii necunoscuți, repetați sau invalizi primesc 400; o fișă inexistentă primește 404; metodele nepermise primesc 405. Sunt acceptate GET, HEAD și OPTIONS. CORS permite citirea din alte origini. Nu există autentificare sau operațiuni de scriere.
Valorile filtrelor
- topic
- health, living, economy, justice, education, population, environment, transport, spending, geography, research, language, heritage, legislation, standards, elections
- collection
- data, documents, research, heritage
- type
- catalog, database, dataset, archive, standard, api, corpus, document
- rights
- explicit, varies, restricted, unknown
- status
- verified-direct, official-link-unverified
- api
- true
- access
- browser, download, api