Avalik API (v1)

Kogu avaldatud arhiiv on kättesaadav versioonitud, ainult-lugemiseks JSON-API kaudu. Iga vastus sisaldab allika- ja litsentsiinfot. Autentimist pole — päringud on anonüümsed.

https://ehtekunst.ee/api/v1

Baas-URL

Kõik lõpp-punktid asuvad aadressi all olevas baasteedes. Nimekirjad on lehekülgedeks jagatud (perPage kuni 100).

Vastuse struktuur

Nimekirjad tagastavad { data: [...], meta: { page, perPage, total, source, license, attributionUrl } }. Üksikkirjed tagastavad { data: {...}, meta }. Vead: { error: { code, message } }.

Juurdepääs ja piirid

Anonüümne, ainult-lugemiseks. CORS on lubatud kõigile päritoludele. Päringuid piiratakse 120 päringuni minutis IP kohta (429 + Retry-After). Ümbernimetatud slug vastab 301-ga uuele URL-ile.

Litsents

Kirjeldavad metaandmed on CC BY 4.0, viita „Ehtekunst.ee". Pildid ei ole üldlitsentsitud. Faktid viitavad algallikatele (MuIS, DEA, monograafiad).

Lõpp-punktid

GET	/api/v1/artists	query, school, gradYearFrom, gradYearTo, page, perPage
GET	/api/v1/artists/{slug}	profile + graph + verified mentions
GET	/api/v1/works	query, artist, material, yearFrom, yearTo, forSale, page
GET	/api/v1/works/{slug}	work + images + relations + exhibitions
GET	/api/v1/exhibitions	query, year, organization, page, perPage
GET	/api/v1/exhibitions/{slug}	participants, works, venue, press
GET	/api/v1/organizations/{slug}	organization + relations
GET	/api/v1/search?q=	grouped results, ≤10 per type (min 2 chars)
GET	/api/v1/timeline?from=&to=	merged typed events by year
GET	/api/v1/graph/{type}/{slug}	hydrated edges with source cards
GET	/api/v1/sources/{id}	a cited source
GET	/api/v1/stats	published counts, year coverage, last-updated
GET	/api/v1/openapi.json	OpenAPI 3.1 document

Näited

curl https://ehtekunst.ee/api/v1/stats
curl "https://ehtekunst.ee/api/v1/artists?query=kask&perPage=5"
curl "https://ehtekunst.ee/api/v1/timeline?from=1950&to=2025"

OpenAPI

Masinloetav OpenAPI 3.1 kirjeldus: /api/v1/openapi.json

MCP-server

Ehtekunst.ee pakub ka MCP-serverit (Model Context Protocol) — lisa see ühenduseks Claude'is või muus MCP-kliendis ja küsi arhiivi käest vestluse teel. Server on õhuke kiht sama avaliku API peal.

Ühendamine: Claude → Settings → Connectors → Add custom connector → https://ehtekunst.ee/mcp