API

Testovacie formuláre je možné používať len po prihlásení, kedy sa automaticky do hlavičky požiadavky vloží váš token.

Autentifikácia: POST /api/auth

Na autentifikáciu sa používa štandardný autentifikačný token JWT (JSON Web Token), ktorý platí 24 hodín.

Následne treba vygenerovaný token pridať do hlavičky každej požiadavky v tvare: authorization: Bearer <TOKEN> kde <TOKEN> je váš token (za slovom Bearer nasleduje medzera a potom token).

parameter význam popis príklady
email* email emailová adresa klient@firma.sk
password* heslo heslo *****
parameter význam popis dátový typ
token autorizačný token JWT autorizačný token string
{"token":"eyJ0eX......"}

Zdrojový kód pre Python:

Zdrojový kód pre PHP:

Demo je prístupné len po prihlásení

Pojmový slovník: Vyhľadanie pojmu: GET /api/search
Vyhľadanie pojmu v slovníku.
parameter význam popis príklady
lemma* lema slovo v základnom tvare mačka
namespace kategória kategória pojmu v hierarchii Zvieratá/Cicavce
parameter význam popis dátový typ
results zoznam pojmov zoznam pojmov pole objektov (pojmov)
[{"základný tvar", "kategória"}]
  • lemma: základný tvar slova (pojmu)
  • namespace: kategória pojmu
{"results": [{"lemma": "mačka","namespace": "Zvieratá/Cicavce"}]}

Zdrojový kód pre Python:

Zdrojový kód pre PHP:

Demo je prístupné len po prihlásení

Pojmový slovník: Informácie o pojme: GET /api/concept
Získanie informácií o pojme.
parameter význam popis príklady
lemma* lema slovo v základnom tvare mačka
namespace* kategória kategória pojmu v hierarchii Zvieratá/Cicavce
parameter význam popis dátový typ
results zoznam vzťahov zoznam vzťahov pole objektov
{"relationship": [{"lemma", "namespace", "direction"}]}}
  • lemma: pojem v základnom tvare
  • namespace: kategória pojmu
  • direction: smer vzťahu
    • D => priamy vzťah
    • R => reverzný-opačný vzťah
  • relationship: vzťah
{"results": { "partOf": [{"lemma": "chvost", "namespace": "Zvieratá/Časti tela","direction": "R"}], "male-female": [{"lemma": "kocúr","namespace": "Zvieratá/Cicavce","direction": "R"}] }}

Zdrojový kód pre Python:

Zdrojový kód pre PHP:

Demo je prístupné len po prihlásení

Extrakcia pojmov z textu: GET /api/extractor
Identifikácia pojmov v texte
parameter význam popis príklady
text* text vstupný text Bežec beží po nábreží.
parameter význam popis dátový typ
response zoznam slov zoznam pojmov pole objektov
  • word: slovo z vety
  • lemma: základný tvar slova
  • pos: slovný druh
  • tag: gramatické kategórie
  • concepts: zoznam nájdených pojmov
    • lemma: základný tvar pojmu
    • namespace: kategória pojmu
    • tokens_count: počet slov pojmu
tokens počet tokenov počet tokenov číslo
{ "response": [ { "word": "Bežec", "lemma": "bežec", "pos": "S", "tag": "SSis1", "concepts": [ { "lemma": "bežec", "namespace": "Roly/Športovci", "tokens_count": 1 } ] }, { "word": "beží", "lemma": "bežať", "pos": "V", "tag": "VKesc", "concepts": [ { "lemma": "bežať", "namespace": "Aktivity/Presun", "tokens_count": 1 } ] }, { "word": "po", "lemma": "po", "pos": "E", "tag": "Eu6", "concepts": [] }, { "word": "nábreží", "lemma": "nábrežie", "pos": "S", "tag": "SSns6", "concepts": [ { "lemma": "nábrežie", "namespace": "Lokality/Miesta", "tokens_count": 1 } ] }, { "word": ".", "lemma": null, "pos": "Z", "tag": "Z", "concepts": [] } ], "tokens": 5 }

Zdrojový kód pre Python:

Zdrojový kód pre PHP:

Demo je prístupné len po prihlásení

Čísla: transformácia čísel na číslovky: GET /api/number-transformator
transformácia čísel na číslovky
parameter význam popis príklady
text* text vstupný text 3 ženy a 3 muži zjedli 2 koláče a 1 chlieb po 13 dňoch. V 1. triede je 21 žiakov a 3 učitelia. V 2. triede je 22 žiakov a 4 učitelia.
parameter význam popis dátový typ
response odpoveď odpoveď (text s nahradenými číslami) text
tokens počet tokenov počet tokenov číslo
{ "response": "tri ženy a traja muži zjedli dva koláče a jeden chlieb po trinástich dňoch . V prvej triede je dvadsaťjeden žiakov a traja učitelia . V druhej triede je dvadsaťdva žiakov a štyria učitelia .", "tokens": 32 }

Zdrojový kód pre Python:

Zdrojový kód pre PHP:

Demo je prístupné len po prihlásení

Čísla: transformácia čísloviek na čísla: GET /api/numeral-transformator
transformácia čísloviek na čísla
parameter význam popis príklady
text* text vstupný text dvetisícdvadsaťšesť
parameter význam popis dátový typ
response odpoveď text s nahradenými číslovkami text
tokens počet tokenov počet tokenov číslo
{"response": "2026","tokens": 1}

Zdrojový kód pre Python:

Zdrojový kód pre PHP:

Demo je prístupné len po prihlásení

Anonymizácia pojmov: GET /api/anonymizer
Identifikácia a anonymizácia pojmov v texte: osoby, lokality, organizácie a súkromné údaje (emaily, telefónne čísla, adresy a pod.)
parameter význam popis príklady
text* text vstupný text Na Ulici Milana Rastislava Štefánika v Brezovej pod Bradlom býval pilot Milan Rastislav Štefánik.
parameter význam popis dátový typ
response zoznam slov spracovaný text pole objektov: slov
[{"word":"slovo1", "labels":[]}, {"word":"slovo2", "labels":["LOC"]},... ]}
  • word: slovo
  • labels: zoznam značiek
    • LOC: lokalita
    • PER/name: krstné meno
    • PER/surname: priezvisko
    • ...
tokens tokeny počet tokenov číslo
{ "response": [ { "word": "Na", "labels": [] }, { "word": "Ulici", "labels": [ "LOC" ] }, { "word": "Milana", "labels": [ "LOC" ] }, { "word": "Rastislava", "labels": [ "LOC" ] }, { "word": "Štefánika", "labels": [ "LOC" ] }, { "word": "v", "labels": [] }, { "word": "Brezovej", "labels": [ "LOC" ] }, { "word": "pod", "labels": [ "LOC" ] }, { "word": "Bradlom", "labels": [ "LOC" ] }, { "word": "býval", "labels": [] }, { "word": "pilot", "labels": [] }, { "word": "Milan", "labels": [ "PER/name" ] }, { "word": "Rastislav", "labels": [ "PER/name" ] }, { "word": "Štefánik", "labels": [ "PER/surname" ] }, { "word": ".", "labels": [] } ], "tokens": 15 }

Zdrojový kód pre Python:

Zdrojový kód pre PHP:

Demo je prístupné len po prihlásení

Zmena tvaru slova: GET /api/wordform
Transformácia tvaru slova (skloňovanie, časovanie, stupňovanie ...) pre vstupné slovo v základnom tvare.
parameter význam popis príklady
lemma* základný tvar slova pojem v základnom tvare Martin
pos slovný druh filter na slovný druh S = podstatné meno
A = prídavné meno
P = zámeno
... kompletný zoznam POS tagov
gender rod filter na rod f = ženský
n = stredný
m = mužský životný
i = mužský neživotný
number číslo filter na rod s = singulár (jednotné číslo)
p = plurál (množné čislo)
case pád filter na pád 1 = nominatív
2 = genitív
...
7 = inštrumentál
form tvar filter na tvar slova SSns2 = podstatné meno, stredný rod, singulár, 2.pád
... kompletný zoznam POS tagov
unknown neznáme slová aj slová, ktoré nie sú v slovníku 0 = nie
1 = áno (dopočítané cez príponu)
parameter význam popis dátový typ
response tvary slova požadované tvary slov (pole) pole tvarov slov
{"tvar": ["slovo1", "slovo2", ...]}
  • tvar: POS značka
  • ["slovo1", "slovo2"...]: tvary slova
tokens tokeny počet tokenov číslo
{ "response": { "SSms1": [ "Martin" ], "SSms5": [ "Martin" ], "SSis1": [ "Martin" ], "SSis4": [ "Martin" ], "SSis5": [ "Martin" ], "AAis1x": [ "Martin" ], "AAis4x": [ "Martin" ], "AAis5x": [ "Martin" ], "AAms1x": [ "Martin" ], "AAms5x": [ "Martin" ], "SSms2": [ "Martina" ], "SSms4": [ "Martina" ], "SSis2": [ "Martina" ], "AAfs1x": [ "Martina" ], "AAfs5x": [ "Martina" ], "SSms3": [ "Martinovi" ], "SSms6": [ "Martinovi" ], "SSms7": [ "Martinom" ], "SSmp3": [ "Martinom" ], "SSis7": [ "Martinom" ], "AAis6x": [ "Martinom" ], "AAms6x": [ "Martinom" ], "AAns6x": [ "Martinom" ], "SSmp1": [ "Martinovia" ], "SSmp5": [ "Martinovia" ], "SSmp2": [ "Martinov" ], "SSmp4": [ "Martinov" ], "SSmp6": [ "Martinoch" ], "SSmp7": [ "Martinmi" ], "SSis3": [ "Martinu" ], "AAfs4x": [ "Martinu" ], "SSis6": [ "Martine" ], "AAfp1x": [ "Martine" ], "AAfp4x": [ "Martine" ], "AAfp5x": [ "Martine" ], "AAip1x": [ "Martine" ], "AAip4x": [ "Martine" ], "AAip5x": [ "Martine" ], "AAnp1x": [ "Martine" ], "AAnp4x": [ "Martine" ], "AAnp5x": [ "Martine" ], "AAfp2x": [ "Martiných" ], "AAfp6x": [ "Martiných" ], "AAip2x": [ "Martiných" ], "AAip6x": [ "Martiných" ], "AAmp2x": [ "Martiných" ], "AAmp4x": [ "Martiných" ], "AAmp6x": [ "Martiných" ], "AAnp2x": [ "Martiných" ], "AAnp6x": [ "Martiných" ], "AAfp3x": [ "Martiným" ], "AAip3x": [ "Martiným" ], "AAis7x": [ "Martiným" ], "AAmp3x": [ "Martiným" ], "AAms7x": [ "Martiným" ], "AAnp3x": [ "Martiným" ], "AAns7x": [ "Martiným" ], "AAfp7x": [ "Martinými" ], "AAip7x": [ "Martinými" ], "AAmp7x": [ "Martinými" ], "AAnp7x": [ "Martinými" ], "AAfs2x": [ "Martinej" ], "AAfs3x": [ "Martinej" ], "AAfs6x": [ "Martinej" ], "AAfs7x": [ "Martinou" ], "AAis2x": [ "Martinho" ], "AAms2x": [ "Martinho" ], "AAms4x": [ "Martinho" ], "AAns2x": [ "Martinho" ], "AAis3x": [ "Martinmu" ], "AAms3x": [ "Martinmu" ], "AAns3x": [ "Martinmu" ], "AAmp1x": [ "Martini" ], "AAmp5x": [ "Martini" ], "AAns1x": [ "Martino" ], "AAns4x": [ "Martino" ], "AAns5x": [ "Martino" ] }, "tokens": 77 }

Zdrojový kód pre Python:

Zdrojový kód pre PHP:

Demo je prístupné len po prihlásení