en cs

Nocheto HTTP API

Nocheto HTTP API poskytuje přístup k informacím o aktuální hře (pozice, strom tahů, celé PGN atp.), hodnoty proměnných z konfigurace a může být použito k spuštění mnoha příkazů.

Je míněno jako rozhraní pro programátory kteří chtějí rozšířit funkcionalitu nocheta. Například můžete vytvořit šachovnici v prohlížeči za pomoci HTML, CSS a JavaScriptu (jako v příkladu níže), nebo vytvořit rozšíření do prohlížeče které otevřou šachové partie/pozice z vašeho oblíbeného šachového serveru rovnou v nochetu, spustí analýzu, vrátí výsledek a zobrazí ho.

Nocheto také obasahuje jednoduchý HTTP server, který můžete použít k odeslání HTML, CSS, JS a dalších souborů do webového prohlížeče.

HTTP API je v defaultním nastavení vypnuto, je potřeba jej zapnout pomocí http příkazu.

HTTP API je dostupné od verze 2.4.0 jako experimentální funkce. Proto musíte spustit nocheto s volbou příkazové řádky --future, jinak nebude http příkaz dostupný.

Dostupné API verze

Nocheto 2.4.0 obashuje API verze 0.1. K této verzi neexistuje dokumentace, můžete si ale stáhnout a prozkoumat příklad v 0.1.

Nocheto 2.5.0 a novější obsahuje API version 0.2. K této verzi neexistuje dokumentace, můžete si ale stáhnout a prozkoumat příklad v 0.2.

Konfigurace

Zde je popis sekce [http] z configurace.

Přidejte následující sekci do vašeho konfiguračního souboru (~/.nocheto/config/nocheto.ini) a vlastnosti jejichž defaultní hodnoty chcete změnit. 


[http]
port = 8080
address = "127.0.0.1"
whitelist = "new;move;flipboard;uu;redo;r;r<;r>;goto;cut;delete;branchup;loadresults;lr;hint;analyze;nag;setnag;comment;bcomment;level;seconds;autoplay;setoption;board;b;undo;u;moves;play;p;switchsounds;fen;tag;stop;speach;echo;ipv4;quit"
rootdir="/home/<your home dir>/.nocheto/http/"
requestlogfile=""

Nyní můžete spustit http příkaz a otevřít odpovídající URL ve vašem internetovém prohlížeči (například http://127.0.0.1:8080/).

port2.0.0

port="8080"

Číslo portu kde bude nocheto očekávat HTTP spojení.

address2.0.0

address="127.0.0.1"

IP adrea kde bud enocheto přijímat HTTP spojení.
Použijte 0.0.0.0 k povolení všech dostupných adres.

whitelist2.0.0

whitelist = "new;move;flipboard;uu;redo;r;r<;r<<;r>;goto;cut;delete;branchup;loadresults;lr;hint;analyze;nag;setnag;comment;bcomment;level;seconds;autoplay;setoption;board;b;undo;u;moves;play;p;switchsounds;fen;tag;quit;stop;speach;echo"

Seznam povolených příkazů které bude nocheto akceptovat skrze HTTP API.

rootdir2.0.0

rootdir = "<$HOME>/.nocheto/http/"

Kořenový adresář pro soubory poskytované nochetem skrze HTTP API.
Defaultní je adresář ~/.nocheto/http/.

requestlogfile3.0.0

requestlogfile=""

Cesta k souboru do kterého bude nocheto logovat HTTP požadavky (pokud je nastaveno).

Příklad v 0.12.4.0

K zobrazení linku ke stažení se musíte přihlásit.

Ke stažení: http_0.1.zip.

Instalace

Rozbalte zip soubor a přesuňte adresář http/ do adresáře ~/.nocheto/.

Příklad v 0.22.5.0

K zobrazení linku ke stažení se musíte přihlásit.

Download: http_0.2.zip.

Instalace

Rozbalte zip soubor a přesuňte adresář http/ do adresáře ~/.nocheto/.

HTTP Web Example