Veřejné API

Vhodné využití

experimenty ve škole nebo na vysoké
malé výzkumné skripty s uvedením zdroje
osobní zkoušení endpointů v prohlížeči

Nevhodné využití

backend pro jiné weby nebo mobilní aplikace
hromadné stahování dat mimo webové rozhraní
provoz služeb třetích stran závislých na našem API

Základní URL

Produkce (přes web): https://anika.cz/api/v1
Lokální vývoj: http://localhost:4003/api/v1 (proxy) nebo http://localhost:4004/v1 (API server)

Odpovědi: JSON { "data": ..., "meta": { ... } }. Při překročení limitu HTTP 429 s hlavičkami X-RateLimit-* a Retry-After. Autentizace není vyžadována.

Moduly

Synonyma — /v1/synonyms
Svátky — /v1/name-days
Obce — /v1/municipalities
Cizí slova — /v1/foreign-words
Latina — /v1/latin
Citáty — /v1/quotes
Zkratky — /v1/abbreviations
Etymologie — /v1/etymology
Pravopis — /v1/spelling
Křížovky — /v1/crossword
Překlady — /v1/translations
Gramatika — /v1/grammar
Autoři — /v1/authors
PSČ — /v1/postal-codes

Endpointy

GET /v1/search?q=
Globální vyhledávání napříč moduly

GET /v1/related?module=&slug=
Související záznamy

GET /v1/daily
Slovo, citát a obec dne

GET /v1/crossword?pattern=
Helper pro křížovky (vzor písmen)

GET /v1/sitemap?module=
Slugy pro sitemap generátor

GET /v1/name-days/today
Dnešní svátek

GET /v1/name-days/week
Svátky v aktuálním týdnu

GET /v1/name-days/by-name?name=
Datum svátku podle jména

GET /v1/name-days/ical
iCal export kalendáře svátků

GET /v1/grammar/pos-labels
Seznam slovních druhů

GET /v1/spelling-quiz
Pravopisný kvíz — otázky

GET /v1/spelling-quiz/check/:id?answer=
Kontrola odpovědi kvízu

GET /v1/game/wordle/daily
Slovní hra — denní slovo

POST /v1/game/wordle/check
Slovní hra — kontrola tipu

POST /v1/tools/write-better
Napiš lépe — návrhy synonym

GET /v1/topics
Tematické stránky — seznam

POST /v1/entry-titles
Dávkové načtení titulků pro oblíbené

GET /v1/municipalities/meta/regions
Seznam krajů pro filtr obcí

GET /v1/name-days/year
Kalendář svátků na celý rok

GET /v1/postal-codes/:code
Detail PSČ

GET /v1/synonyms
Synonyma — seznam / vyhledávání

GET /v1/synonyms/random
Synonyma — náhodný záznam

GET /v1/synonyms/:slug
Synonyma — detail

GET /v1/name-days
Svátky — seznam / vyhledávání

GET /v1/name-days/:slug
Svátky — detail

GET /v1/municipalities
Obce — seznam / vyhledávání

GET /v1/municipalities/:slug
Obce — detail

GET /v1/foreign-words
Cizí slova — seznam / vyhledávání

GET /v1/foreign-words/random
Cizí slova — náhodný záznam

GET /v1/foreign-words/:slug
Cizí slova — detail

GET /v1/latin
Latina — seznam / vyhledávání

GET /v1/latin/random
Latina — náhodný záznam

GET /v1/latin/:slug
Latina — detail

GET /v1/quotes
Citáty — seznam / vyhledávání

GET /v1/quotes/random
Citáty — náhodný záznam

GET /v1/quotes/:slug
Citáty — detail

GET /v1/abbreviations
Zkratky — seznam / vyhledávání

GET /v1/abbreviations/:slug
Zkratky — detail

GET /v1/etymology
Etymologie — seznam / vyhledávání

GET /v1/etymology/:slug
Etymologie — detail

GET /v1/spelling
Pravopis — seznam / vyhledávání

GET /v1/spelling/:slug
Pravopis — detail

GET /v1/crossword
Křížovky — seznam / vyhledávání

GET /v1/crossword/:slug
Křížovky — detail

GET /v1/translations
Překlady — seznam / vyhledávání

GET /v1/translations/:slug
Překlady — detail

GET /v1/grammar
Gramatika — seznam / vyhledávání

GET /v1/grammar/:slug
Gramatika — detail

GET /v1/authors
Autoři — seznam / vyhledávání

GET /v1/authors/:slug
Autoři — detail

GET /v1/postal-codes
PSČ — seznam / vyhledávání

GET /v1/postal-codes/:slug
PSČ — detail

Licence dat

Data pocházejí z otevřených zdrojů: Wikislovník a Wikiquote (CC BY-SA 3.0), RÚIAN a PSČ (CC BY 4.0). API neuděluje širší licenci než zdroje — respektujte podmínky a uveďte autorství.