Add "change-keycode" feature.

Also raise version number to 0.1.2.

Author: juhaerk

VERSION

@@ -1 +1 @@
-0.1.1
+0.1.2

debian/changelog

@@ -1,3 +1,9 @@
+abitti-ktpapi (0.1.2) stable; urgency=medium
+
+  * Add "change-keycode".
+
+ -- Puavo Org <dev@opinsys.fi>  Tue, 14 Dec 2021 12:45:16 +0200
+
 abitti-ktpapi (0.1.1) stable; urgency=medium
 
   * Fix service startup in USB-stick case.

doc/API.md

@@ -7,7 +7,7 @@ Following commands are supported
 * `load-exam [filename] [keycodefile]`
 * `start-new-exam [filename] [keycodefile]`
 * `start-loaded-exam`
-* `change-keycode` (unimplemented)
+* `change-keycode`
 * `get-status`
 * `get-exam`
 * `get-script-info`
@@ -69,6 +69,15 @@ Starts exam already loaded to the server
 ```json
 {"error":false,"start-exam":{"startTime":"2020-11-03T12:16:53.248Z"},"cmd":"start-new-exam"}
 ```
+
+### Change-keycode
+
+* Input `change-keycode`
+* Output: JSON `{"error":true/false, "change-keycode":{...}, "cmd":"change-keycode"}`
+```json
+{"error":false, "change-keycode":{"keyCode":"1234","confirmationCode":"xx"}, "cmd":"change-keycode"}
+```
+
 ### Get-Status
 Returns status of the surveillance view on the server containing current keycode and students.
 * Input `get-status`

src/apiwatcher

@@ -208,6 +208,22 @@ execute_startnewexam() {
                  "start-exam:${output_start}"
 }
 
+change_keycode() {
+    local keycode_json
+    if keycode_json=$(
+        curl -s \
+             -H 'Accept: application/json, text/javascript, /; q=0.01' \
+             --compressed \
+             -H 'Content-Type: application/json; charset=UTF-8' \
+             -H 'X-Requested-With: XMLHttpRequest' \
+             --data-raw '' \
+             'http://localhost/single-security-code'); then
+        write_output "change-keycode:${keycode_json}"
+    else
+        output_error 'Error in changing exam keycode'
+    fi
+}
+
 get_script_info() {
     script_version="$(cat "$script_version_file")"
     write_output "$(printf 'script-version:"%s"' "$script_version")"
@@ -254,6 +270,9 @@ case "$cmd_cmd" in
     ping)
         execute_ping
         ;;
+    change-keycode)
+        change_keycode
+        ;;
     get-script-info)
         get_script_info
         ;;