API

API - zoznam endpointov

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).

Vstupné parametre

email: emailová adresa
password: heslo

Výstupné hodnoty

response: odpoveď
token: autorizačný token

Zdrojový kód pre Python:

endpoint = "https://pojmy.kinit.sk/api/auth"
logindata = {"email": "moj@email.loc", "password": "superTajneHeslo"}
response = requests.post(endpoint, data=logindata)

Zdrojový kód pre PHP:

$logindata = ["email" => "moj@email.loc", "password" => "superTajneHeslo"];
$ch        = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://pojmy.kinit.sk/api/auth");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($logindata));
$response  = curl_exec($ch);

Pojmový slovník: Vyhľadanie pojmu: GET /api/search

Vyhľadanie pojmu v slovníku.

Vstupné parametre

token: autorizačný token
lemma: slovo v základnom tvare
namespace: kategória (nepovinné)

Výstupné hodnoty

results: správa

Zdrojový kód pre Python:

endpoint = "https://pojmy.kinit.sk/api/search"
headers = {"Authorization": "Bearer MOJ-TOKEN"}
params = {"lemma": "beh"}
response = requests.get(endpoint, params=params, headers=headers)

Zdrojový kód pre PHP:

$params  = ["lemma" => "beh"];
$headers = ["Content-Type: application/json", "Authorization: Bearer MOJ-TOKEN"];
$ch      = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://pojmy.kinit.sk/api/search?".http_build_query($params));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$response  = curl_exec($ch);

Pojmový slovník: Informácie o pojme: GET /api/concept

Získanie informácií o pojme.

Vstupné parametre

token: autorizačný token
lemma: slovo v základnom tvare
namespace: kategória

Výstupné hodnoty

results: zoznam vzťahov

Zdrojový kód pre Python:

endpoint = "https://pojmy.kinit.sk/api/concept"
headers = {"Authorization": "Bearer MOJ-TOKEN"}
params = {"lemma": "beh"}
response = requests.get(endpoint, params=params, headers=headers)

Zdrojový kód pre PHP:

$params  = ["lemma" => "beh"];
$headers = ["Content-Type: application/json", "Authorization: Bearer MOJ-TOKEN"];
$ch      = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://pojmy.kinit.sk/api/concept?".http_build_query($params));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$response  = curl_exec($ch);

Extrakcia pojmov z textu: GET /api/extractor

Identifikácia pojmov v texte

Vstupné parametre

token: autorizačný token
text: vstupný text

Výstupné hodnoty

response: zoznam slov
tokens: počet tokenov

Príklad:
Bežec beží po nábreží.

Zdrojový kód pre Python:

endpoint = "https://pojmy.kinit.sk/api/extractor"
headers = {"Authorization": "Bearer MOJ-TOKEN"}
params = {"text": "Bežec beží po nábreží."}
response = requests.get(endpoint, params=params, headers=headers)

Zdrojový kód pre PHP:

$params  = ["text" => "Bežec beží po nábreží."];
$headers = ["Content-Type: application/json", "Authorization: Bearer MOJ-TOKEN"];
$ch      = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://pojmy.kinit.sk/api/extractor?".http_build_query($params));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$response  = curl_exec($ch);

Čísla: transformácia čísel na číslovky: GET /api/number-transformator

transformácia čísel na číslovky

Vstupné parametre

token: autorizačný token
text: vstupný text

Výstupné hodnoty

response: odpoveď (text s nahradenými číslami)
tokens: počet tokenov

Príklad:
3 ženy a 3 muži zjedli 2 koláče a 1 chlieb po 13 dňoch.

Zdrojový kód pre Python:

endpoint = "https://pojmy.kinit.sk/api/number-transformator"
headers = {"Authorization": "Bearer MOJ-TOKEN"}
params = {"text": "3 ženy a 3 muži zjedli 2 koláče a 1 chlieb po 13 dňoch."}
response = requests.get(endpoint, params=params, headers=headers)

Zdrojový kód pre PHP:

$params  = ["text" => "3 ženy a 3 muži zjedli 2 koláče a 1 chlieb po 13 dňoch."];
$headers = ["Content-Type: application/json", "Authorization: Bearer MOJ-TOKEN"];
$ch      = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://pojmy.kinit.sk/api/number-transformator?".http_build_query($params));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$response  = curl_exec($ch);

Čísla: transformácia čísloviek na čísla: GET /api/numeral-transformator

transformácia čísloviek na čísla

Vstupné parametre

token: autorizačný token
text: vstupný text

Výstupné hodnoty

response: odpoveď (text s nahradenými číslovkami)
tokens: počet tokenov

Príklad:
dvetisícdvadsaťšesť

Zdrojový kód pre Python:

endpoint = "https://pojmy.kinit.sk/api/numeral-transformator"
headers = {"Authorization": "Bearer MOJ-TOKEN"}
params = {"text": "dvetisícdvadsaťšesť"}
response = requests.get(endpoint, params=params, headers=headers)

Zdrojový kód pre PHP:

$params  = ["text" => "dvetisícdvadsaťšesť"];
$headers = ["Content-Type: application/json", "Authorization: Bearer MOJ-TOKEN"];
$ch      = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://pojmy.kinit.sk/api/numeral-transformator?".http_build_query($params));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$response  = curl_exec($ch);

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.)

Vstupné parametre

token: autorizačný token
text: vstupný text

Výstupné hodnoty

response: spracovaný text
tokens: počet tokenov

Príklad:
Na Ulici Milana Rastislava Štefánika v Brezovej pod Bradlom býval pilot Milan Rastislav Štefánik.

Zdrojový kód pre Python:

endpoint = "https://pojmy.kinit.sk/api/anonymizer"
headers = {"Authorization": "Bearer MOJ-TOKEN"}
params = {"text": "Na Ulici Milana Rastislava Štefánika v Brezovej pod Bradlom býval pilot Milan Rastislav Štefánik."}
response = requests.get(endpoint, params=params, headers=headers)

Zdrojový kód pre PHP:

$params  = ["text" => "Na Ulici Milana Rastislava Štefánika v Brezovej pod Bradlom býval pilot Milan Rastislav Štefánik."];
$headers = ["Content-Type: application/json", "Authorization: Bearer MOJ-TOKEN"];
$ch      = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://pojmy.kinit.sk/api/anonymizer?".http_build_query($params));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$response  = curl_exec($ch);