Dokumentacija API

Publičny read-only API medžuslověnskogo lexikona i praslověnskogo slovnika — za storonji integracije.

Dostajanje ključa

Vsaky zapyt trěbuje API-ključ. Tvorite jego bezplatno v vašem akkontě.

Upravljati API-ključami

Popytajte v brauzeru

Interaktivny plejgraund — posylajte zapyty iz tej strany, bez vašego API-ključa i bez rashodovanja jego limita.

Otvoriti plejgraund

Autentifikacija

Peredavajte ključ kako Bearer-token v zaglavju Authorization v vsakem zapytu.

Authorization: Bearer islx_your_key_here

Limity zapytov

Limit zavisit od grupy endpointov: slovnik i Praslověnsky — 60/min, biblioteka — 60/min, iskanje po korpusu (KWIC) — 20/min (drožje vypočislitelno). Sčita sę odděljno na jeden API-ključ.

Každy otgovor nesje headery X-RateLimit-Limit/Remaining/Reset - ne trěba čekati 429, aby uznati, kolko ostaje.

Format otvěta

Endpointy spiskov vraćajų masiv data i objekt pagination.

{ "data": [ ... ], "pagination": { "total": 123, "limit": 25, "offset": 0 } }

Pogrěški vraćajų mašino-čitljivy code i člověko-čitljivo message.

{ "error": { "code": "not_found", "message": "..." } }

Endpointy

GET /api/public/v1/words

Iskanje/spisok slov lexikona. Parametry: search, limit (po umolčanju 25, maksimum 100), offset.

curl -H "Authorization: Bearer islx_..." \
  "https://interslavic-lexicon.com/api/public/v1/words?search=voda&limit=10"

GET /api/public/v1/words/:slug

Polna informacija o jednom slově po slug: gramatičny polja, značenja i prěvody.

curl -H "Authorization: Bearer islx_..." \
  "https://interslavic-lexicon.com/api/public/v1/words/voda-NOUN"

GET /api/public/v1/proto

Iskanje/spisok praslověnskogo slovnika (ESSJa). Parametry: search, limit, offset.

curl -H "Authorization: Bearer islx_..." \
  "https://interslavic-lexicon.com/api/public/v1/proto?search=voda"

GET /api/public/v1/proto/:id

Polna informacija o jednom praslověnskom slově po id, vključajų morfemy.

curl -H "Authorization: Bearer islx_..." \
  "https://interslavic-lexicon.com/api/public/v1/proto/123"

GET /api/public/v1/library

Iskanje/spisok tekstov biblioteky (bez polnogo teksta). Parametry: search (po naslovu/avtoru), limit, offset.

curl -H "Authorization: Bearer islx_..." \
  "https://interslavic-lexicon.com/api/public/v1/library?search=princ&limit=10"

GET /api/public/v1/library/:slug

Polna informacija o jednom tekstě biblioteky po slug, vključajų polny tekst.

curl -H "Authorization: Bearer islx_..." \
  "https://interslavic-lexicon.com/api/public/v1/library/maly-princ"

POST /api/public/v1/corpus/kwic

Iskanje po korpusu v formatě KWIC (KeyWord In Context) - prijima CQL-zapyt, vraća sovpadenja s lěvym/pravym kontekstom (±10 tokenov) i metadanymi dokumenta.

Sintaksis CQL je urězan: jeden ili několiko [segmentov] rjadom, vnutri - uslovja tipa attr="značenje" ili attr!="značenje", sojedinjena črěz &. Dostupne atributy: lemma, pos, surfaceForm, ili bilo kaky gramatičny znak (npr. case="acc"). Bez OR i regularnyh vyrazov. Maksimum 5 segmentov na zapyt.

curl -X POST -H "Authorization: Bearer islx_..." -H "Content-Type: application/json" \
  -d '{"query": "[lemma=\"dom\"]", "limit": 10}' \
  "https://interslavic-lexicon.com/api/public/v1/corpus/kwic"