diff options
Diffstat (limited to 'data/www/2.html')
| -rw-r--r-- | data/www/2.html | 40 |
1 files changed, 40 insertions, 0 deletions
diff --git a/data/www/2.html b/data/www/2.html new file mode 100644 index 0000000..04eb96a --- /dev/null +++ b/data/www/2.html @@ -0,0 +1,40 @@ +<head> +<meta charset=UTF-8> +<link rel="stylesheet" type="text/css" href="css/main.css"> +</head> +<b><text style=font-size:25px>Dokumentacija API klicev prek HTTP strežnika</text><!-- <img align=right src=img.png alt=SLIKA width=300 height=170 />--> +<br><i>Anton Luka Šijanec, 13. december 2019</i><br></b> +<p> +Klici se delajo z GET ali POST zahtevami na virtualno podmapo strežnika /api/<br> +Kot argumente uporabimo argumente z vrednostmi po RFC specifikaciji, bodi si v URI-ju ali v POST telesu.<br> +Priporočam uporabo GET zahtev, saj zafrkavanje z Content-Length headerji ni potrebno. +</p><p> +Vse zahteve so avtenticirane z uporabo WWW-Authentication standarda z geslom, ki ga nastavite po meri. Uporabniško ime je sijaneciot (oziroma program_ime, če to spremenljivko spremenite), geslo pa lahko spreminjate in je privzeto prav tako nastavljeno na program_ime.<br> +Priporočam, da geslo pred priklopom v večjo mrežo ali internet spremenite.<br> +Sprememba gesla: prek FTP strežnika, datoteka /403/webgeslo.txt ali z API ukazom /api/pwd?g=novogeslo<br> +</p><p> +Kode napak so standardne, če niste avtenticirani, dobite 401, če je dostop prepovedan je 403, napaka na strani strežnika je 5xx, uporabniška napaka/napaka klienta je 4xx, preusmeritve so 3xx, status OK pa je 2xx.<br> +</p><p> +NUJNO! pri API ukazu ne napišite zadnje poševnice, /api/pwd ni isto kot /api/pwd/, slednja bo vrnila <i>404: Napačen ukaz ali napačno ime datoteke.</i> +</p><p> +Spodaj so našteti podprti ukazi, za argumente posameznega ukaza pa zahtevajte ukaz brez argumentov. Če argumentov ne navedete in so za izvedbo ukaza potrebni, tako ali tako dobite napako <i>400: Napačna zahteva</i> in izpiše se vam seznam potrebnih in opcijskih argumentov, razen če ni drugače navedeno; na primer ukaz /api/rst ne potrebuje argumentov in takoj ponovno zažene sistem. +</p><p> +<pre> + <a href=/api/pin>/api/pin - ročna nastavitev pinov (branje in pisanje)</a> + <a href=/api/res>/api/res - prikaz resursov sistema</a> + <a href=/api/sap>/api/sap - nastavitev dostopne točke</a> + <a href=/api/sta>/api/sta - priklop na drugo dostopno točko</a> + <a href=/api/gid>/api/gid - pridobi informacije o napravi in o omrežju</a> + <a href=/api/pwm>/api/pwm - nastavi frekvenco pulzoširinske modulacije (brez argumentov pove trenutno vrednost)</a> + <a href=/api/rst>/api/rst - znova zažene sistem in programje (brez argumentov)</a> + <a href=/api/slp>/api/slp - globoko spanje za n mikrosekund</a> + <a href=/api/now>/api/now - vrne podatek o trenutnem času v obliki UNIX časovnega žiga (brez argumentov)</a> + <a href=/api/pwd>/api/pwd - sprememba gesla</a> + <a href=/api/tms>/api/tms - nastavitev časa (ob povezavi v splet se čas sicer vsakih 300 sekund posodobi iz 0.pool.ntp.org)</a> + <a href=/api/ren>/api/ren - preimenovanje datotek, pod "haubo" isto kot /api/mov</a> + <a href=/api/mov>/api/mov - premikanje datotek, pod "haubo" isto kot /api/ren</a> + + <a href=/test>/test - vedno vrne 200: OK, za namen testiranje povezave, npr. če je kontrolna plošča še vedno povezana na napravo.</a> +</pre> +</p><hr> +Preberi še: <a href=2.html>Dokumentacija API klicev prek HTTP strežnika</a> |